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This publication is oriented to the F level 
assembler program (the assembler) 
functioning in the IBM System/360 Operating 
System (MFT and MVT). 


This publication is divided intc an 
introduction and four sections which 
describe the following: 


1. Assembler options and data set 
requirements. 


2. Use of IBM-provided catalogel 
procedures for assembling; assembling 
and linkage editing; assembling, 
linkage editing, and executing 
assembler language source prcgrams. 


3. Use and interpretation of the 
assembler listing. 


4. Programming considerations. 


In addition, the appendixes prcvide a 
procedure for dynamic invocation cf the 
assembler, a list and explanation of object 
output cards, and a sample program listing. 


Other System Reference Library 
publications in the IBM System/360 
Operating System series provide fuller, 
more detailed discussions of the topics 
introduced in this publication: a careful 
reading of the publication OS Introduction, 
Order No. GC28-6534, is recommended. 
Knowledge of the assembler language is 
assumed. Where appropriate, the reader is 
directed to the following publications. 


OS Job Control Language Reference, Order 
No. GC28-6704 


OS Storage Fstimates, Order 
No. GC28-6551 


Preface 


OS Loader _and Linkage Editor, Order 
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RELEASE 21 LISTINGS 


Maintenance 
The sample program listings have been 
replaced ky Release 21 Assembler F 
listings. 


NUM ANC SIMT OPTIONS 


New Programming Feature 
The NUM and STMT options are now the 


default values assumed when the TERM 
ception is specified. 


SUMMARY OF AMENCMENTS 
FOR GC26- 3756-6 
OS RELEASE 21 


Maintenance 
The assembler can operate on IBM 
System/370 Models 135 and up. 





MESSAGES 


Maintenance 
Certain explanations of messages have 
been rewritten for clarity. 


TITLE CHANGFS 


Maintenance 
References to CS publications have Leen 
altered to reflect their current 
titles. 








Through the medium of job control 
statements, the programmer specifies job 
requirements directly to the operating 
system, thus eliminating many of the 
functions previously performed by the 
operating personnel. The job consists of 
one or more jok steps. For example, the 
job of assembling, linkage-editing, and 
executing a source program involves three 
job steps: 


1. Txanslating the source program. i.e., 
executing the assembler component of 
the operating system to produce an 
object module. 


2. Processing the output of the 
assembler, i.e., executing the 
linkage-editor component of the 
operating system to produce a load 
module. 


3. Executing the assembled and 
linkage-edited program, i.e., 
executing the load module. 


A procedure is a sequence of job control 
language statements specifying a jcb. 


Introduction 


Procedures may enter the system via the 
input stream or from a library of 
procedures, which are previously defined 
and contained in a procedure library. The 
input stream is the flow cf job control 
statements and, optionally, input data 
entering the system from one input device. 
At the sequential scheduling system level 
of the operating system, only one input 
stream may exist at a time. 


The job definition (JOE), execute 
(EXEC), data definition (DD), and delimiter 
(/*) job control statements are shown in 
this publication as they are used to 
specify assembler processing. LCetailed 
explanations of these statements are given 


in CS Job Control Language Reference. 


Operating system factors influencing 
program preparation, such as terminating 
the program, saving and restoring general 
registers, and linking of independently 
produced object modules, are discussed in 
“Programming Considerations", as are guides 
to determine whether assembler dictionary 
sizes and complexity limitations of source 
statements will be exceeded. 
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Assembler Options and Data Set Requirements 


Assembler Options 


The programmer may specify the assembler 
options listed in Figure 1 in the PAR™ 
field of the EXEC statement. The cftions 
can be coded in any order. They must be 
separated by commas with no embedded 
blanks. The entire field must be contained 
between apostrophes or parentheses. 
Parentheses allow the PARM field to be 
continued onto another card, when 
necessary. If an entry is omitted, a 
standard setting is assumed by the 
assembler. The standard default values are 
underlined in Figure 1. 


The options in Figure 1 are defined as 
follows: 

CECK -- The object module is placed on the 
device specified in the SYSPUNCH DD 
statement. 

LOAD -- The object module is placed on the 
device specified in the SYSGO DD 
statement. 


Note: Specification of the parameter LOAD 
causes object output to be written ona 
data set with ddname SYSGO. This action 
occurs independently of the output on 
SYSPUNCH caused by the parameter DECK. The 
output on SYSGO and SYSPUNCH is identical 
except that SYSPUNCH is closed with a 
disposition of LEAVE, and SYSGO is closed 
with a disposition of REREAD. 


LIST -- An assembler listing is produced. 

TEST -- The object module contains the 
special source symbol table required by 
the test translator (TESTRAN) rceutine and 
the TSO Test command processor. 

XREF -- The assembler produces a 
cross-reference table of symbols as part 
of the listing. 

RENT -- The assembler checks for a possible 
coding violation of program 
reenterability. 


The prefix NO is used with the above 
options to indicate which options are not 
wanted. 


LINECNT=nn This parameter specifies the 
number of lines to be printed between 
headings in the listing. The permissible 
range is 01 to 99 lines. 

NOALGN -- The assembler suppresses -the 
diagnostic message IEU033 ALIGNMENT ERROR 
if fixed point, floating point, or 
logical data referenced by an instruction 
operand is not aligned on the proper 
boundary. The message will be prcduced, 


hawauvuar FAK KN FARRAR NAR OR EN SNR Ee AES ARR 
aswnwe ee ~~ te Ne a Ne te Ge as he aN KH OLD 
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(e.g-, by a branch) which are not aligned 
on the proper (halfword) boundary. See 
the "Model 85 Programming Considerations" 
section for information on alignment 
requirements. 

ALGN -- The assembler does not suppress the 
alignment error diagnostic message. 

OS -- The assembler will have complete 
Operating System Assembler F Capability. 

DOS -- The assembler will behave like Disk 
Crerating System (LOS) Assemblers C and 
F. Anything defined in either of these 
assemblers with the exception cf &SYSPARM 
will be accepted. CXL, CXL, and OPSYN 
will be treated as undefined Q-type [C 
and DS statements and RLDs will appear in 
the Relocation LVictionary in order of 
their occurrence (unsorted). The DOS 
option is incompatible with the LOAL, 
TEST, RENT, NOALGN, or TERM options. If 
any of these options are specified along 
with DOS, the assembler generates a 
diagnostic message (IFU078). 

TERM -- The assembler writes diagnostic 
information on the SYSTERM data set. 
Refer to Appendix E for a description of 
SYSTERM output. Cptions NUM and STMT can 
be specified only if TERM is used. 

NUM -- The line number field (columns 
73-80) or TSO, through the EDIT command, 
supplied numbers are written on SYSTERM 
in the beginning of each statement line 
for which diagnostic information is 
given. This option is valid only in 
connection with TERM. 

STMT ~- Statement number will be written on 
SYSTERM for statements for which 
diagnostic information is given. This 
option is valid only in connection with 
TERM. 


Note 1: It is recommended to use the NUM 
option when using the TERM option, to avoid 
unnecessary spacing on a terminal listing. 
When the TERM option is specified, the NUM 
and STMT options are taken as the default 
values. 


Note 2: If option NOTERM is used for an 
assembly, NCNUM and NOSTMT will not ke 
listed after *#OPTIONS IN EFFECT* in the 
diagnostic section of the SYSPRINT listing. 


If contradictory options are entered, 
e.g., LIST, NCLIST, the rightmost option, 
NOLIST, is used. 


The following is an example of 
specifying assembler opticns: 


mm cen 6 


rm ATF WAMI FCF NAN RIMNTN TAS Ve 
LUAU pOANIUT VAY *gWUYDEN gli Gol 


DECK LOAD LIST TEST 
NODECK,NOLOAD, NOLIST, NOTEST, NOXREF 


PARM= | 


LINECNT= 
f 


XREF nn, TERM NUM STMT), 
55,NOALGN, DOS, NORENT, NOTERM, NONUM, NOSTMT 


ALGN OS RENT 





Figure 1. Assembler Options 


Assembler Data Set Requirements 


The assembler requires the following four 
data sets: 


e SYSUT1, SYSUT2, SYSUT3 -- utility data 
sets used as intermediate external 
storage. 


e SYSIN -- an input data set containing 
the source statements to be precessed. 


In addition to the above, four additional 
data sets may be required: 


e SYSLIE -- a data set containing macro 
definitions (for macro definitions not 
defined in the source progran) and/or 
source coding to be called for through 
COPY assembler instructions. 


e SYSPRINT -- a data set containing 
output text for printing (unless NOLIST 
option is specified). 


e SYSPUNCH -- a data set containing 
object module output usually for 
punching (unless NODECK opticn is 
specified). 


-@ SYSGO -- a data set containing cbject 
module output usually for the linkage 
editor (only if LOAD option is 
specified). 


e SYSTERM -- data set containing 
diagnostic information (if the TERM 
option is specified). 


The above data sets are described in the 
following text. The ddname that rust be 
used in the DD statement describing the 
data set appears as the heading fcr each 
descrirftion. 


DDnames SYSUT1, SYSUT2, SYSUT3 


These utility data sets are used by the 
assembler as intermediate external storage 
devices when processing the source program. 
The input/output device(s) assigned to 
these data sets must be capable of 
sequential access to records. © The 
assembler does not support multi-volume 
utility data sets. Refer to the OS Storage 
Estimates manual for the space required. 


DDname SYSIN 


This data set contains the input to the 
assembler -- the source statements to be 
processed. The input/output device 
assigned to this data set may be either the 
device transmitting the input stream, or 
another sequential input device designated 
by the programmer. The CL statement 
describing this data set appears in the 
input stream. The IEM-supplied procedures 
do not contain this statement. 


[Dnames SYSLIB 


From this data set, the assembler obtains 
macro definitions and assembler language 
statements to be called by the COPY 
assembler instruction. It is a partitioned 
data set and each macro definition or 
sequence of assembler statements is a 
separate member, with the member name Leing 
the macro instruction mnemonic or COPY code 
name. The data set may be defined as 
SYS1.MACLIB or a user's private macro 
definition or COPY library. SYS1.MACLIB 
contains macro definitions for the system 
macro instruction provided by IBM. A 
user's private library may be concatenated 
with SYS1.MACLIB. The two libraries should 
have the same attributes, i.e., the same 
blocking factors, block sizes, and record 
formats. If different block sizes are used 
the data sets with the largest block size 
must be specified first. The OS Job 
Control Language Reference publication 
explains the concatenation of the data 
sets. 


CDname_ SYSPRINT 


This data set is used by the assemkler to 
produce a listing. Output may be directed 
to a printer, magnetic tape, CASI, or a 
remote terminal (TSO). The assembler uses 
the machine code carriage-control 
characters for this data set. 


DDname SYSPUNCH 


The assembler uses this data set to produce 
the object module. The input/output unit 
assigned to this data set may be either a 
card punch or an intermediate storage 
device (capable of sequential access). 
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[pDname_SYSGO 


This is a CASDC, magnetic tape, or card 
punch data set used by the assembler. It 
contains the same output text as SYSPUNCH. 
It is used as input for the linkage editor 
and may also be used as a punch device (see 
Note under “Assembler Options") . 


CIname SYSTERM 


This data set is used by the assembler to 
write diagnostic information. The output 
unit assigned to this data set must be a 
remote terminal (TSO). 


Defining Data Set Characteristics 


Pefore a data set can be made available to 
a problem program, descriptive information 
defining the data set must be placed into a 
data control block for the access routines. 
Sources of information for the data control 
block are keyword operands in the DCB macro 
instruction or, in some cases, the DD 
statement, data set label, or user's 
problem program. General information 
concerning data set definition is ccntained 
in the OS Data Management Services Guide 
‘Manual. Characteristics of data sets 
supplied by the DCB macro instructicn are 


described in the OS Data Management Macro 
Instructions manual. 


The specific information that must be 
supplied depends upon the data set 
organization and access method. ‘The 
following access methods are used to 
process the assemkler data sets: 


Access Method Data Sets 
QSAM (Queued Sequential) SYSPRINTI, SYS- 
PUNCH, SYSGO, 


SYSIN, SYSTERM 

BSAM (Basic Sequential) SYSUT 1, SYSUT2, 
SYSUT3 
BPAM (BaSic Partitioned) SYSLIB 

Figure 3 summarizes the assembler 
capabilities and restrictions on record 
length and format, as well as the blocksize 
buffering facilities available to the user. 
The values shown in Figure 3 are based upon 
the minimum OS MFT main storage 
requirements of Assembler F (44K), which 
will allow a symbol table length of 
approximately 7000 kbytes. If more than the 
minimum main storage is available, the 
block sizes and buffer numbers can be 
increased. However, if the user specifies 
a combination of blocking and buffering 
which does not leave room for the symbol 
table. either message IFU996 will he issued 
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or abnormal termination of the task will 
occur (ABEND 804). 


In addition to the data set 
characteristics shown in Figure 3, the 
following options are available to the user 
Instructions publication). Opticns not 
shown below are fixed by the assembler and 
cannot be specified. 


Data Sets Options 

DEVD (device type) 
BFALN (buffer koundary 
alignment) 

EBUFL (buffer length) 
EROPT (error option) 


SYSIN, 
SYSPRINT, 


SYSPUNCH, 
SYSGO 


DEVD (device tyre) 
OPTCC (optional ser- 
vice for validity 
checking and chained 
scheduling) 

TRTCH (if 7-track tapes 
are used, TRITCH=C must 
be specified) 


SYSUT1, 2, 3 


Return Codes 


Figure 2 shows the return codes issued Ly 
the assembler for use with the 
COND=parameter of JCE or EXEC statements. 


| The COND= parameter is explained in OS Job 


The return code issued by the assembler 
is the highest severity code that is: 


1. Associated with any error detected Ly 
the assembler (see Appendix A for 


diagnostic messages and severity 


codes) . 

2. Associated with MNOTE messages 
produced by macro instructions. 

3. Associated with an unrecoverakle I/0 


error occurring during the assembly. 


If a permanent I/O errcr occurs on any 
of the assembler files or a [CL card for a 
required data set is missing, or there is 
insufficient main storage availakle, a 
message is printed on SYSFRINT (or on the 
operator's console if the SYSPRINT DD card 
is missing or if the I/O error is on 
SYSPRINT) and a return with a user return 
code of 20 is given by the assemkler. This 
terminates the assembly. 


Figure 2. 


Minor errors detected; | 
successful program execution is| 
probable | 


Errors detected; unsuccessful _ | 
program execution is possible | 


Serious errors detected: | 
unsuccessful program execution | 
is probable | 


Critical errors detected; | 


normal execution is impossible |. 


Unrecoverable 1/0 error | 
occurred during assembly or | 
Missing data sets; assembly | 
terminated | 


Return Codes 


Assembler Options and Lata Set Requirements 


13 


LRECL 


RECFM , 
@ 


BLKSIZE 
@ 


main storage 
requirements 


©©O O09 


SYSIN 


Fixed at 80 


User must specify 
in LABEL or DD card 


F, FS, FBS, FB, 
FBST, FBT, FT, 
FST 


User must specify 
in LABEL or DD card, 
must be a multiple of 
LRECL 


Optional; if 
omitted 2 is used 


BLKSIZE times 
BUFNO can not be 
greater than 3600 


LI = BLKSIZE 
times BUFNO 


Minimum amount of main storage required for the assembler is the largest of the following: 


SYSLIB 


Fixed at 80 


User must specify 
In LABEL or DD card 


F, FB, FBT, FT 


User must specify 
in LABEL or DD card, 
must be a multiple of 
LRECL 


Set by assembler 
to | 


ee aa 


BLKSIZE can not 
be greater than 3600 


L2 = BLKSIZE 


SYSTERM 
SYSPRINT 


F and M set by 
assembler, user may 
specify B and/or T 
in label or DD card 


FM, FMB, FMT, FMBT 


Optional, 
if omitted 
BLKSIZE=LRECL 


Optional; if 
omitted 2 is used 


BLKSIZE times 
BUFNO can not be 
greater than 1210 


L3 = BLKSIZE 
times BUFNO 


SYSPUNCH 
Fixed at 80 


F set by assemb- 
ler, user may spec- 
ify B and/or T in 
label or DD card 


F, FB, FT, FBT 


Optional, but must 
be a multiple of 
LRECL; if omitted 
BLKSIZE=LRECL 


Optional; if 
omitted 3 is used for 
unit record and 1 for 
other devices 


BLKSIZE times 
BUFNO can not be 
greater than 400 


L4 = BLKSIZE 
times BUFNO 


(1) 
(2) 


SYSGO 


Fixed at 80 


F set by assemb- 
ler, user may spec- 
ify B and/or Tin 
label or DD card 


F, FB, FT, FBT 


SYSUT] 
SYSUT2 
SYSUT3 


N/A 


Fixed for U 


Optional, but must| Optional, but must be 


be a multiple of 
LRECL; if omitted 
BLKSIZE=LRECL 


Optional, if 
omitted 3 is used for 
unit record and 1 for 
other devices 


BLKSIZE times 
BUF NO can not be 
greater than 400 


L5 = BLKSIZE 
times BUFNO 


45056 
Ly +L, + 41000 


in the range of 550- 
3624; the value speci- 
fied on the SYSUT] DD 
card is chosen for all 
three work files; if 
omitted an adequate 


JIvalue is chosen by 


the assembler, 


© 


User can not specify; 
either 1 or 2 


BLKSIZE should be the 
value calculated by the 
assembler algorithm. 


® 


(3) Ls + Ly + Ls + 41000 


Maximum amount of main storage that the assembler can effectively use is approximately 500, 000 bytes 


For MVT environment add 5,000 for core required 


"Correction of Dictionary Overflow. " 


Figure 3. 
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Data Set Characteristics 


U = undefined, F = fixed length records, B = blocked records, S = standard blocks, 
T = track overflow, M= machine code carriage control 


Blocking is not allowed on unit records devices. Blocking on other direct access can not 
be greater than the track size unless T is specified on RECFM. If BLKSIZE is not a multiple 
of LRECL, BLKSIZE is truncated. 


A smaller blocksize may have to be specified for SYSLIB and/or SYSUT 1,2, and 3 
if global or local dictionaries overflow. See item 4 under 





This section describes four IBM-provided 
cataloged procedures: a procedure fcr 
assembling (ASMFC), a procedure for 
assembling and linkage editing (ASMFCL), 
and a procedure for assembling, linkage 
editing, and executing (ASMFCLG), anda 
procedure for assembling and 
loader-executing (ASMFCG). The procedures 
rely on conventions regarding the naming of 
device classes. These conventions, shown 
in Figure 4, must be incorporated into the 
system at system generation time. 







Any devices allowing 
sequential access to records 
for reading and writing 





SYSSQ ; 


SYSCP Card punches 


Cevice Naming Conventicns 






Figure 4. 


To use cataloged procedures, EXEC 
statements naming the desired procedures 
are placed in the input stream fcllowing 
the JOB statement. Subsequently, the 
specified cataloged procedure is brcught 
from a procedure library and merged into 
the input stream. 


Device Classname Devices Assigned 


Cataloged Procedures 


Cataloged Procedure for Assembly (ASMF'C) 


This procedure requests the operating 
system to load and execute the assembler. 
The name ASMFC must be used to call this 
precedure. The result of execution is an 
object module, in punched card form, and an 
assembler listing. 


In the following example, input enters 
via the input stream. The statements 
entered in the input stream tc use this 
procedure are: 


//jobname JOB 
//stepname EXEC PROC= ASMFC: 
//ASM.SYSIN DD * 

| 


source program statements 
| 


/* (delimiter statement) 


The statements of the ASMFC procedure are 
brought from the procedure library and 
merged into the input stream. 


Figure 5 shows the statements that make 
up the ASMFC procedure. 
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/IASM PGM=IEUASM,REGION=50K 
HSYSLIB DSNAME=SYS1.MACLIB,DISP=SHR 


HSYSUT1 DSNAME=&SYSUT1,UNIT=SYSSQO,SPACE=(1700,(400,50)), 
i SEP=(SYSLIB) ; 
HSYSUT2 DSNAME=&SYSUT2,UN!T=SYSSQ,SPACE=(1700,(400,50)) 


HSYSUT3 DSNAME=&SYSUT3,SPACE=(1700, (400,50)), 
i UNIT=(SYSSQ,SEP=(SYSUT2,SYSUT1,SYSLIB)) 
JISYSPRINT SYSOUT=A 


/ISYSPUNCH SYSOUT=B 


PARM= or COND=parameters may be added to this statement by the EXEC statement that calls the procedure (see Overriding Statements in 
Cataloged Procedures). The system name IEUASM identifies Assembler F. 


This statement identifies the macro library data set. The data set name SYS1.MACLIB is an IBM designation. 
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These statements specify the assembler utility data sets. The device classname used here, SYSSQ, may represent a collection of tape 
drives, or direct-access units, or both. The !/O units assigned to this name are specified by the installation when the system is generated. 
A unit name, e.g., 2311 may be substituted for SYSSQ. The OSNAME parameters guarantee use of Dedicated Workfiles if this feature is 


part of the Scheduler. 


The SEP=subparameter in statement 5 and the SPACE=parameter in statements 3, 4, and 5 are effective only if the device assigned is a 
direct-access device: otherwise they are ignored. The space required is dependent on the make-up of the source program. 


The OS Job Control Language Reference publication explains space allocation. 


This statement defines the standard system output class, SYSOUT=A, as the destination for the assembler listing. 


This statement describes the data set that will contain the object module produced by the assembler. 


Figure 5. 


Cataloged Procedure for Assembly and 
Linkage Editing (ASMFCL) 


This procedure consists of two job steps: 
assembling and linkage editing. The name 
ASMFCL must be used to call this procedure. 
Execution of this procedure results in the 
production of an assembler listing, a 
linkage editor listing, and a load mcdule. 


The following example assumes input to 


the assembler via the input job stream. It 


also makes provision in the //LKED job step 
for concatenating the input to the linkage 
editor from the //ASM job step with any 
additional linkage editor input in the 
input job stream. This additional input 
can be a previously produced object module 
which is to be linked to the object module 
produced by jok step //ASM. 


An example of the statements entered in 
the input stream to use this procedure is: 





Cataloged Procedure fcr Assembly (ASMFC) 


//jobname JOB 
//stepname EXEC PROC=ASMFCL 
//ASM.SYSIN DD - 


t 
' 
source program statements 


/* 
//LKED.SYSIN DD * 
] 
t 
1 


necessary only if linkage 
editor is to combine modules 
or read linkage editor control 
information from the job stream 


object module or 
linkage editor 
control statements 


The procedure is brought from the 
precedure library and merged into the input 
stream. 


Figure 6 shows the statements that make 
up the ASMFCL procedure. Only those 
statements not previously discussed are 
explained. 


ASM 
HISYSLIB 


HSYSUT1 
// 


HSYSUT2 


HSYSUT3 
i 


HSYSPRINT 
//ISYSPUNCH 
H/SYSGO 

If 


//(LKED 
// 


HISYSLIN 
Hf 


//SYSLMOD 
// 


/{SYSUT1 
// 


HSYSPRINT 


PGM=IEUASM,PARM=LOAD,REGION=50K 
DSNAME=SYS1.MACLIB,DISP=SHR 


DSNAME=&SYSUT1,UNIT=SYSSQ,SPACE=(1700,(400,50)), 
SEP=(SYSLIB) 


DSNAME=&SYSUT2,UNIT=SYSSQ,SPACE=(1700,(400,50)) 


DSNAME=&SYSUT3,SPACE=(1700,(400,50)), 
UNIT=(SYSSQ,SEP=(SYSUT2,SYSUT1,SYSLIB)) 


SYSOUT=A 

SYSOUT=B 
DSNAME=&LOADSET,UNIT=SYSSQO,SPACE=(80,(200,50)), 
DISP=(MOD,PASS) 


PGM=IEWL,PARM=(X REF,LIST,NCAL),REGION=96K, 
COND=(8,LT,ASM) 


DSNAME=&LOADSET,DISP=(OLD,DELETE) 
DDNAMESSYSIN 


DSNAME=&GOSET(GO),UNIT=SYSDA,SPACE=(1024,(50,20,1)}, 
DISP=(MOD,PASS) 


DSNAME=&SYSUT1,UNIT=(SYSDA,SEP=(SYSLIN,SYSLMOD)), 
SPACE=(1024,(50,20)) 


SYSOUT=A 


In this procedure the SYSGO DD statement describes a temporary data set -- the object module -- which is to be passed to the linkage editor. 


This statement initiates linkage editor execution. The linkage editor options in the PARM=field cause the linkage editor to produce a 
cross-reference table, module map, and a list of al! control statements processed by the sp editor. The NCAL option suppresses the 


automatic library call function of the linkage editor. 


This statement identifies the linkage editor input data set on the same one produced as output by the assembler. 


This statement is used to concatenate any input to the linkage editor from the input stream with the input from the assembler. 


This statement specifies the linkage-editor output data set (the load module). As specified, the data set will be deleted at the end of the job. If it is 
desired to retain the load module, the DSNAME parameter must be respecified and a DISP parameter added. See “’Overriding Statements in Cataloged 
Procedures”. If the output of the linkage editor is to be retained, the DSNAME parameter must specify a library name and member name where the 
load module is to be placed. The DISP parameter must specify either KEEP or CATLG. 


This statement specifies the utility data set for the linkage editor. 


This statement identifies the standard output class as the destination for the linkage editor listing. 





Figure 6. Cataloged Procedure fcr Assembling and Linkage Editing (ASMFCL) 


Cataloged Procedure for Assembly, Linkage 


Editing, and Execution (ASMFCLG) 


This procedure consists of three job steps: 
assembling, linkage editing, and executing. 


Figure 7 shows the statements that make 
up the ASMFCLG procedure. Only those 
statements not previously discussed are 
explained in the figure. 


The name ASMFCLG must be used to call 
this procedure. Assembler and linkage 
editor listings are produced. 


The statements entered in the input 
stream to use this procedure are: 


//jobname JOB 
/{stepname EXEC PROC=ASMFCLG 
//ASM.SYSIN DD * 


source program statements 


/* 1 
//LKED.SYSIN DD * nae ; 

} necessary only if linkage editor 
object module or is to combine modules or read 
linkage editor linkage editor control information 
control statements from job stream 

/* 

//GO.ddname DD _ (parameters) 

//GO.ddname DD (parameters) 

/{GO.ddname DD * only if necessary 
| 

problem program input 

' 

/* 
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//ASM 
//SYSLIB 


//SYSUT1 
// 


I/ISYSUT2 


/ISYSUT3 
// 


//SYSPRINT 
//SYSPUNCH 
/1SYSGO 

i! 

//LKED 

// 


/ISYSLIN 
// 


HSYSLMOD 


// 


/ISYSUT1 
// 


//SYSPRINT 
//GO 


EXEC 
DD 
DD 


DD 
DD 


DD 
DD 
DD 


EXEC 


DD 
DD 


DD 


DD 


PGM=IEUASM,PARM=LOAD,REGION=50K 
DSNAME=SYS1.MACLIB,DISP=SHR 


DSNAME=&SYSUT1,UNIT=SYSSO,SPACE=(1700,(400,50)), 
SEP=(SYSLIB) 


DSNAME=&SYSUT2,UNIT=SYSSQO,SPACE=(1700,(400,50)) 


DSNAME=&SYSUT3,SPACE=(1700,(400,50)), 
UNIT=(SYSSO,SEP=(SYSUT2,SYSUT1,SYSLIB)) 


SYSOUT=A 

SYSOUT=B 
DSNAME=&LOADSET,UNIT=SYSSO,SPACE=(80,(200,50)), 
DISP=(MOD,PASS) 
PGM=!IEWL,PARM=(XREF,LET,LIST,NCAL),REGION=96K, 
COND=(8,LT,ASM) 


DSNAME=&LOADSET,DISP=(OLD,DELETE) 
DDNAME=SYSIN 


DSNAME=&GOSET(GO),UNIT=SYSDA,SPACE=(1024,(50,20,1)), 
DISP=(MOD,PASS) 


DSNAME=&SYSUT1,UNIT=(SYSDA,SEP=(SYSLIN,SYSLMOD)), 
SPACE=(1024,(50,20)) 


SYSOUT=A 


PGM=*,LKED.SYSLMOD,COND=((8,LT,ASM),(4,LT,LKED)) 


The LET linkage-editor option specified in this statement causes the linkage editor to mark the load module as executable even though errors were 
encountered during processing. 


The output of the linkage editor is specified as a member of a temporary data set, residing on a direct-access device, and is to be passed to a 
succeeding job step. : 


This statement initiates execution of the assembled and linkage edited program. The notation *.LKED.SYSLMOD identifies the program to be 
executed as being in the data set described in job step LKED by the DD statement named SYSLMOD. When running with MVT the REGION 
Parameter can be calculated with the help of the OS Storage Estimates publication. 


Figure 7. 


Cataloged Procedure for Assembly and //jobname 
Loader Execution (ASMFCG) //stepname 
//ASM.SYSIN 
This procedure consists of two job steps 
assembling and loader-executing. the 
result of loader-execution is a combination 
of linkage-editing and loading the program 
for execution. Load modules for program /* 
libraries are not produced. //GO.ddname 
; //GO.ddname 
//GO.ddname 
Figure 8 shows the statements that make 
up the ASMFCG procedure. Only those 
statements not previously discussed are 
explained in the figure. P 


The name ASMFCG must be used tc call 
this procedure. 
listings are produced. 


Assembler and loader 


The statements entered in the input stream 
to use this procedure are: 
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Cataloged Procedure for Assembly, Linkage Editing and Execution 


JOB 
EXEC 


DD 
| 
| 
| 


sou be program 


DD 
DD 
.DD 


(ASMFCLG) 


PROC=ASMFCG 
* 


(parameters) 


(1 parameters) only 


if 
necessary 


problem program input 


Overriding Statements in Cataloged 
Procedures 


Any farameter in a cataloged procedure can 
be overridden except the PGM= parameter in 
the EXEC statement. Such overriding of 
statements or fields is effective only for 
the duration of the job step in which the 
statements appear. The statements, as 
stored in the procedure library of the 
system, remain unchanged. 


Overriding for the purposes of 
respecification, addition, or nullification 
is accomplished by including in the input 
stream statements containing the desired 
changes and identifying the statements tc 
be overridden. 


EXEC Statements 


The PARM= and COND= parameters can be added 
or, if present, re-specified by including 
in the EXEC statement calling the procedure 
the notation PARM.stepname=, or 

COND. stepname=, followed by the desired 
parameters. "“Stepname" identifies the EXEC 
statement within the procedure to which the 
modification applies. Overriding the PGM= 
parameter is not possible. 


If the procedure consists of ncre than 
one job step, a PARM.stepname= or 
COND.stepname= parameter may be entered for 
each step. The entries must be in order, 
i.e., PARM.step1=, PARM.step2=, etc. 


CL Statements 


All parameters in the operand field of DE 
statements may be overridden by including 
in the input stream (following the EXEC 
card calling the procedure) a DD statement 
with the notation //stepname.ddname in the 
name field. "Stepname" refers tc the jcb 
step in which the statement identified by 
“ddname"™ appears. 


Examples 


In the assembly procedure ASMFC (Figure 5), 
the production of a punched object deck 
could be suppressed and the UNIT= and 


SPACE= parameters of data set SYSUT1 
re-specified, by including the fcllowing 
statements in the input stream: 


//stepname EXEC PROC=ASMFC, 

// PARM. ASM=NODECK 
//ASM.SYSUTI DD UNIT=2311, x 
// SPACE=(200, (300, 40)) 
//ASM.SYSIN DD * 


In procedure ASMFCLG (Figure 7), 
suppressing production of an assembler 
listing and adding the COND= parameter to 
the EXEC statement, which specifies 
execution of the linkage editor, may be 
desired. In this case, the FXEC statement 
in the input stream would appear as 
follows: 


//stepname EXEC PROC=ASMFCLG, x 
// PARM. ASM=(NOLIST, LOAD), x 
// COND ,.LKED=(8, LT, stepname. ASM) 
Note: Overriding the LIST parameter 





effectively deletes the PARM=LOAL so this 
must be repeated in the override statement. 


For current execution of procedure 
ASMFCLG, no assembler listing would be 
produced, and execution of the linkage 
editor job step //LKELE would be suppressed 
if the return code issued by the assemkler 
(step ASM) was greater than 8. . 

Using the procedure ASMFCL (Figure 6) 
to: 


1. Read input from a non-labeled 9-track 
tape on unit 282 that has a standard 
blocking factor of 10. 


2. Put the output listing on a labeled 
tape TAPE10, with a data set name of 
PROG1 and a blocking factor of 5. 


3. Block the SYSGO output of the 
assembler and use it as input to the 
linkage editor with a blocking factor 
of 5. 
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NO 


Ww 


/ASM EXEC PGM=IEUASM,PARM=LOAD’,REGION=50K 

//SYSLIB DD  DSNAME=SYS1.MACLIB,DISP=SHR 

//SYSUT1 DD  DSNAME=&SYSUT1,UNIT=SYSSO,SPACE=(1700,(400,50)), x 

Hl SEP=(SYSLIB) 

/ISYSUT2 DD DSNAME=&SYSUT2,UNIT=SYSSO,SPACE=(1700,(400,50)) 

//SYSUT3 DD  DSNAME=&SYSUT3,SPACE=(1700,(400,50)), x 

I UNIT=(SYSSQ,SEP=(SYSUT2,SYSUT1,SYSLIB)) 

HISYSPRINT DD SYSOUT=A . 

HISYSPUNCH DD SYSOUT=B 

/ISYSGO DD  DSNAME=&LOADSET,UNIT=SYSSO,SPACE=(80,(200,50)), x 
DISP=(MOD,PASS) 

GO EXEC PGM=LOADER,PARM='MAP,PRINT,NOCALL,LET’ 

/ISYSLIN DD DSNAME=&LOADSET,DISP=(OLD,DELETE) 

HISYSLOUT DD SYSOUT=A 


: This statement initiates loader-execution. The loader options in the PARM=field cause the loader to produce a map, print the map and diagnostics. 
The NOCALL option is the same as NCAL for linkage editor and the LET option is the same as for linkage editor. 


oO N 


Figure 8. 


Mm 


This statement defines the loader input data set as the same one produced as output by the assembler. 


This statement identifies the standard output class as the destination for the loader listing. 


Cataloged Procedure fcr Assembly and Loader-Execution 


(ASMFCG) 


- Linkage edit the module only if there Note: The order of appearance of ddnames 
are no errors in the assembly, i.e., within job steps ASM and LKED has been 
CONI=0. preserved. Thus, SYSPRINT precedes SYSGO 

within step ASM. The ddname ASM.SYSIN was 

- Linkage edit on to a previously placed last since SYSIN does not occur at 


allocated and cataloged data set 
USER.LIBRARY with a member name of 


PROG. 


all within step ASM. These pcints are 
covered in "Appendix A. Using Cataloged and 


In-stream Frocedures® in the OS Job Control 
Language Reference manual. 


The input stream appears as fcllows: 


// jobname JOB To assemble two programs, linkage edit 
//stepname EXEC PROC=ASMFCL, x the two assemblies into one load module and 
// COND .LKED=(0,NE.,stepname. ASM) execute the load module, using the 


J/ASM.SYSPRINT DD DSNAME=PROG1, UNIT=TAPE, 


ff VOLUME=SER=TAPE10,DCB=(BLKSIZE=605) 
//ASM.SYSGO —-DD-_—sODCB=(BLKSIZE=400) 

//ASM.SYSIN DD —_ UNIT=282, LABEL=(,NL), 

If DCB=(RECFM=FSB, BLKSIZE=800) 


//LKED .SYSIN DD DCB=stepname.ASM.SYSGO 
//LKED.SYSLMOD DD DSNAME=USER .LIBRARY (PROG) ,DISP=OLD 


/* 
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cataloged procedures described above, the 
input stream appears as follows: 


//stepnamel 
//ASM.SYSGO 
// 


i/ 
//ASM,SYSIN 


/* 

//stepname2 
//ASM.SYSGO 
//KSM.SYSIN 


/* 
//LKED.SYSLIN 
//LKED .SYSIN 


/* 
//GO.ddname 


EXEC 
DOD 


DD 


EXEC 
DD 


DD 
DD 
ENTRY 


PROC=ASMFC, PARM. ASM='LOAD' 
DSNAME=8&LO ADSET, UNIT=SYSSQ, 
SPACE=(80, (200, 50)), 

DISP=(MOD, PASS), DCB=(BLKSIZE=400) 
* 


i] 
1 
‘ 
source program | statements 
' 
' 
1 


PROC=ASMFCLG 
DCB=(BLKSIZE=400), DISP=(MOD, PASS) 


* 


1 
' 
‘ 
source program 2 statements 


DCB=BLKS!IZE=400 


* 


PROG 


dd cards for GO step 


The OS Job Control Language Reference 
publication provides an additional 


description of overriding techniques. 
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Assembler Listing 


The assembler listing (Figure 10) consists 
of five sections, ordered as follows: 
external symbol dictionary items, the 
source and object program statements, 
relocation dictionary items, symbol cross 
reference table, and diagnostic messages. 
In addition, three statistical messages may 
appear in the listing: 


1. After the diagnostics, a 
statements-flagged message indicates 
the total numker of statements in 
error. It appears as follows: nnn 
STATEMENTS FLAGGED IN THIS ASSEMBLY. 


2. After the statements-flagged message, 
the assembler prints the highest 
severity code encountered (if 
non-zero). This is equal tc the 
assembler return code. The message 
appears as follows: nn WAS HIGHEST 
SEVERITY CODE. 


3. After the severity code, the assembler 
prints a count of the number cf 
records read from SYSIN and from 
SYSLIB. It also prints the cptions 
for the assembly. (See the section 
"Assembler Options".) These messages 
appear as follows: 


*STATISTICS* SOURCE RECORDS (SYSIN) = 
nnnnn SOURCE RECORDS (SYSLIB)= nnnnn 
*OPTIONS IN EFFECT* xxxx,XxXxxXxx, etc. 


4. After the options in effect, the 
assembler prints a count of lines 
printed, which appears as follows: 
nnn PRINTED LINES. This is a count of 
the actual number of 121-byte records 
generated by the assembler; it may be 
less than the total number cf printed 
and blank lines appearing on the 
listing if the SPACE n assembler 
instruction is used. For a SPACE n 
that does not cause an eject, the 
assembler inserts n blank lines in the 
listing by generating n/3 blank 
121-byte records -- rounded to the 
next lower integer if a fraction 
results; e.g., for a SPACE 2, neo blank 
records are generated. The assembler 
does not generate a blank record to 
force a page eject. 


In addition to the above items, the 
assembler prints the deck identification 
| (as specified in the TITLE statement) and 
current date on every page of the listing. 
If the timer is available, the assembler 
prints the time of day to the left of the 
date on page 1 of the ESD listing. This is 
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the time when printing starts, rather than 
the start of the assembly, and is intended 
only to provide unique identification for 

assemblies made on the same day. The time 
is printed as hh.mm, where hh is the hour 

of the day (midnight beginning at 00), and 
mm is the number of minutes past the hour. 


External Symbol Dictionary (ESD) 


This section of the listing contains the 
external symbol dictionary information 
passed to the linkage-editor or loader in 
the object module. The entries describe 
the control sections, external references, 
and entry points in the assembled program. 
There are six types of entries, shown in 
Figure 9, along with their associated 
fields. The circled numbers refer to the 
corresponding heading in the sample listing 
(Figure 10). The X's indicate entries 
accompanying each type designation. 





Figure 9. 


Types of ESC Entries 


@ This column contains the name of every 
external dummy section, control 
section, entry point, and external 


symbol. 


@ This column contains the type 
designator for the entry, as shown in 
the figure. The type designators are 
defined as: 


SD--Names section definition. The 
symbol appeared in the name field 
of a CSECT or START statement. 

LD--The symbol appeared as the operand 
of the ENTRY statement. 

ER--External reference. The symbol 


AaAnneared acs the operand of an FYTPN 
nneared as the orerand of an 


ee ar 


statement, or was defined as a 
V-type address constant. 

PC--Unnamed control section (private 
code) definition. 

CM--Common control section definition. 
XD--External dummy section (Same as PR, 
Pseudo Register in the Linkage 

Editor manual). 


WX--Weak external reference. The 


symbol appeared as the operand of a 


WXTRN statement. 


This column contains the external 
symbol dictionary identification 
number (ESDIC). The number is a 
unique two-digit hexadecimal number 
identifying the entry. It is used by 
the LE entry of the ESD and by the 
relocation dictionary for 
cross-referencing the ESD. 


This column contains the address of 
the symbol (hexadecimal notation) for 
SD- and ID-type entries, and zeros for 
ER- and WX-type entries. For PC- and 
CM-type entries, it indicates the 
beginning address of the control 
section. For XD-type entries, it 
indicates the alignment by printing a 
number one less than the number of 
bytes in the unit of alignment, e.g., 
7 indicates double word alignment. 


This column contains the assembled 
length, in bytes, of the ccntrol 
section (hexadecimal notation). 


This column contains, for LD-type 
entries, the identification (IL) 
number assigned to the ESE entry that 
identifies the control section in 
which the symbol was defined. 
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oa. @ © 0 5 | 6] EXTERNAL SYMBOL CICTIONARY 


SYMBOL TYFE ID ALLER LENGTH LD ID 


SAMPLR SD 01 000000 0003C8 


EXAM SAMPLE PROGRAM PAGE 
LCC OBJECT COLE ALDR1 ACER2 STMT SOURCE STATEMENT FOLOCT71 9/09/ 
000024 D200 1003 5008 00003 00008 72+ MVC TSWITCH, LSWITCH 
73 MOVE TNUMBER,LNUMBER FROM LIST ENTRY 335000 
74+* NEXT STATEMENT GENERATED FOR MOVE MACRC 
00002A D202 1000 5009 00000 00009 75+ MVC TNUMBER, LN UWiBER 
76 MOVE TADDRESS,LADDRESS TO TABLE ENTRY 340000° 
T71+* NEXT TWO STATEMENTS GENERATED FCR MOVE MACRO 
000030 5820 500C 0000c 718+ L 2,LACLRESS 
000034 5020 1004 00004 79+ ST 2, TADDRESS 
000038 8756 C008 00018 80 LISTLOOP BXLE R5,R6, MORE LCCE THRCUGH THE LIST 345000 
00003C DSEF C248 COF8 00258 00108 81 CLC TESTTIABL (240) , TABLAREA 350000 
000042 4770 C080 00090 82 BNE NOTRIGHT 355000 
000046 0000 0000 00000 83 EL NOLABEL 
**# ERROR *** 
OOOO04A DS55F C33C CIE8B 0034C 001F8 84 CLC TESTLIST (96) ,LISTAREA 360000° 
000050 4770 C080 00090 85 BNE NOTRIGHT 365000 
EXAM RELOCATION DICTIONARY PAGE 1 
POS.ID  REL.IC. FLAGS ALDRESS 9/09/71 
01 01 oc 000204 
01 01 oc 000214 
o CROSS-REF ERENCE PAGE 1 
SYMBOL LEN VALUE DEFN REFERENCES 9/09/71 
BEGIN 00004 000000 00057 0155 0157 0173 0184 0186 0220 
EXIT 00004 000082 00095 0110 
HIGHER 00002 OOOOF8 00129 0124 
THBO005 00001 00007F 00092 0089 
IHBOOO5A 00002 000080 00093 0088 
IHB0007 00001 OOOO0EF 00107 0104 
IHB0007A 00002 O000BE 00108 0103 
LADDRESS 00004 00000C 00211 0078 
LIST 00001 000000 00207 0065 
LISTAREA 00008 0001F8 00155 0064 0084 0221 
LISTEND 00008 000248 00160 0064 0221 
LISTLCOP 00004 000038 00080 0112 
LNAME 00008 000000 00208 0123 
LNUMBER 00003 000009 00210 0075 
LOOP 00004 OO000DE 00122 0127 0130 0156 0180 0185 
LSWITCH 00001 000008 00209 0072 0111 
MORE 00004 000018 00066 0080 
NOLABEL #**##UNDEFINEL*#*#** 0083 
NONE 00001 000080 00115 0067 0111 0119 0131 
EXAM CIAGNOSTICS FAGE 1 
STMT ERROR CODE MESSAGE 9/09/71 


83 IEU024 NEAR OPERAND COLUMN 1--UNDEFINED SYMBOL 


1 STATEMENT FLAGGEC IN THIS ASSEMBLY 
8 WAS HIGHEST SEVERITY CODE 
*STATISTICS* SOURCE RECORDS (SYSIN) = 191 SOURCE RECORDS (SYSIIB) = 833 
*OPTIONS IN EFFECT* LIST, DECK, NOLOAD, NORENT, XREF, NOTEST, ALGN, OS, NOTERM, LINECNT = 70 
359 PRINTED LINES 


Figure 10. Assembler Listing 
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PAGE 


17.10 9 


Source and Object Program 


This section of the listing documents the 
source statements and the resulting object 
program. 


@ This is the four-character deck 


identification. It is the symbol that 
appears in the name field of the first 
TITLE statement. The assembler prints 
the deck identification and date (item 
16) on every page of the listing. 


This is the information taken from the 
Operand field of a TITLE statement. 


Note: TITLE, SPACE and EJECT 
statements will not appear in the 
source listing unless the statement is 
continued onto another card. Then the 
first card of the statement is 
printed. However, any of these three 
types of statements, if generated as 
Macro instruction expansion, will 
never be listed regardless cf 
continuation. 


Listing page number. Each section of 
the listing starts with page 1. 


This column contains the assembled 
address (hexadecimal notation) of the 
object code. 


This column contains the object code 
produced by the source statement. ‘The 
entries are always left- justified. 
The notation is hexadecimal. Entries 
are machine instructions or assembled 
constants. Machine instructions are 
printed in full with a blank inserted 
after every four digits (twc bytes). 
Constants may be only partially 
printed (see the PRINT assenbler 
instruction in the OS Assembler 
Language publication). 


These two columns contain effective 
addresses (the result of adding 
together a base register value and 
displacement value): 


a. The column headed ADDR1 contains 
the effective address for the first 
Operand of an SS instruction. 

b. The column headed ADDR2 ccntains 
the effective address of the second 
operand of any instructicn 
referencing storage. 


Both address fields contain six 
digits; however, if the high-order 
digit is a zero, it is not frinted. 


This column contains the statement 
number. A plus sign (+) to the right 
of the number indicates that the 


statement was generated as the result 
of macro instruction processing. 


This column contains the source 
program statement. The following 
items apply to this section of the 
listing: 


a. Source statements are listed, 
including those brought into the 
program by the COPY assembler 
instruction, and including macro 
definitions submitted with the main 
program for assembly. Listing 
control instructions are not 
printed, except for the following 
case: PRINT is listed when PRINT 
ON is in effect and a PRINT 
statement is encountered. 


b. Macro definitions obtained from 


SYSLIB are not listed. 


c. The statements generated as the 


result of a macro instruction 
follow the macro instruction in the 
listing. 


d. Assembler or machine instructions 


in the source program that contain 

variable symbols are listed twice: 

as they appear in the source input, 
and with values substituted for the 
variable symbols. 


e. Diagnostic messages are not listed 


inline in the source and object 
program section. An error 
indicator, ***ERROR***, follows the 
statement in error. ‘The message 
appears in the diagnostic section 
of the listing. 


f. MNCTE messages are listed inline in 


the source object program section. 
An MNCTE indicator appears in the 
diagnostic section of the listing 
for MNCTE statements other than 
MNOTE*. The MNOTE message format 
is serverity code, message text. 


g- The MNOTE* form of the MNOTE 


statements results in an inline 
message only. An MNOTE indicator 
does not appear in the diagnostic 
section of the listing. 


h. When an error is found ina 


programmer macro definition, it is 
treated the same as any other 
assembly error: the errcr 
indication appears after the 
statement in error, and a 
diagnostic is placed in the list of 
diagnostics. However, when an 
error is encountered during the 
expansion of a macro instruction 
(Ssystem- or programmer-defined) the 
error indication appears in place 
of the erroneous statement which is 
not listed. The error indication 
follows the last statement listed 
before the erroneous statement was 
encountered, and the associated 
diagnostic message is placed in the 
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list of diagnostics. 

i. Literals that have not been 
assigned locations by an LTIORG 
statement appear in the listing 
following the END statement. 
Literals are identified by the 
equal (=) Sign preceding ther. 

j- If the END statement contains an 
operand, the transfer address 
appears in the location cclumn 
(LOC) . 

k. In the case of COM, CSECT, and 
DSECT statements, the location 
field contains the beginning 
address of these control sections, 
i.e., the first occurrence. 

l. In the case of EXTRN, WXTRN, ENTRY, 
and DXC instructions, the location 
field and object code field are 
blank. 

m. For a USING statement, the location 
field contains the value of the 
first operand. 

n. For LTORG and ORG statements, the 
location field contains the 
location assigned to the literal 
pool or the value of the ORG 
operand. 

oO. For an EQU statement, the location 
field contains the value assigned. 

p- Generated statements always print 
in normal statement format. 

Because of this, it is pcssible for 
a generated statement to occupy 
three or more continuaticn lines on 
the listing. This is unlike source 
statements, which are restricted to 
two continuation lines. 


Note: When the listing is directed to a 
terminal under TSO, the following items 
apply to ICTL, EJECT, and SPACE: 


ICTL - the end column, operand e, must be 
within 41-71. 

EJECT- only one blank line is created on 
the terminal listing. 

SPACE- the decimal value specified in the 
operand is divided by three, and the 
integer result indicates the number 
of blank lines created. 


15) This column contains the identifier of 
the assembler (F) and the date when 
this version was released by System 
Development Division to DPD Program 
Information Department. 

16) Current date (date run is made). 


@ Identification-sequence field from the 
source statement. 


Relocation Dictionary 


This section of the listing contains the 


relocation Gictionary infurmation passed to 
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the linkage editor in the object module. 
The entries describe the address constants 
in the assembled program that are affected 
by relocation. 


@ This column contains the external 
symbol dictionary ILC number assigned 
to the ESD entry that describes the 
control section in which the address 
constant is used as an operand. 


® This column contains the external 
symbol dictionary ILC number assigned 
to the ESD entry that describes the 
control section in which the 
referenced symbol is defined. 


@ The two-digit hexadecimal numker in 
this column is interpreted as follow: 


First Digit. A zero indicates that 
the entry describes an A-type or 
Y-type address constant. A one 
indicates that the entry descriktes 
a V-type address constant . A two 
indicates that the entry descrikes 
a Q-type address constant. A three 
describes a CXL entry. 

nd Digit. The first three bits 
of this digit indicate the length 
of the constant and whether the 
base should be added or subtracted: 


Bits 0 and 1 Bit 2 
00 = 1 byte 0=+ 
01 = 2 bytes 9 
10 = 3 bytes 
11 = 4 bytes 


@ This column contains the assembled 
address of the field where the address 
constant is stored. 


Cross Reference 


This section of the listing information 
concerns symbols which are defined and used 
in the program. 


This column contains the symbols. 


This column states the length (decimal 
notation), in bytes, of the field 
occupied by the symbol value. 


This column contains either the 
address the symbol represents, ora 
value to which the symbol is equated. 


This column contains the statement 
number of the statement in which the 
symbol was defined. 


This column contains the statement 
numbers of statements in which the 
symbol appears as an operand. In the 


case of a duplicate symbol, the 
assembler fills this column with the 
message: 


+++ DUPL ICATE++*+# 


The following notes apply to the 
cross-reference section: 


e Symbols appearing in V-type address 
constants do not appear in the 
cross-reference listing. 


e A PRINT OFF listing control instruction 
does not affect the production of the 
cross-reference section of the listing. 


e In the case of an undefined symrbcl, the 
assembler fills columns 23, 24, and 25 
with the message: 


*4** *UNDEFINED****, 


Diagnostics 


This section contains the diagnostic 
messages issued as a result of error 
conditions encountered in the prcgram. The 
text, severity code, and explanatcry notes 
for each message are contained in “Appendix 
ae : 


@ This column contains the number of the 
statement in error. 


© This column contains the message 
identifier. 


29) This column contains the message, and, 
in most cases, an operand cclumn 
pointer that indicates the vicinity of 
the error. In the following example, 
the approximate location of the 
addressability error occurred in the 
9th column of the operand field: 


Example: 
STMT ERROR CODE MESSAGE 


21 {EU035 NEAR OPERAND COLUMN 9 -- ADDRESSABILITY ERROR 


The following notes apply to the 
diagnostic section: 


e An MNOTE indicator of the form NMOTE 
STATEMENT appears in the diagnostic 
section if an MNOTE statement other 
than MNCTE * is issued by a macro 
instruction. The MNOTE statement 
itself is inline in the source and 
object program section of the listing. 
The operand field of an MNOTE * is 
printed as a comment, but does not 
appear in the diagnostic section. 


e A message identifier consists of six 
characters and is of the form: 
IEUXxx 


IEU identifies the issuing agent as 
Assembler F, and xxx is a unique 
number assigned to the message. 


Note: Editing errors in system macro 
definitions (macro definitions included in 
a macro library) are disccvered when the 
macro definitions are read from the macro 
library. This occurs after the END 
statement has been read. They will 
therefore be flagged after the END 
statement. If the programmer does not know 
which of his system macros caused an error 
it is necessary to punch all system macro 
definitions used in the program, including 
inner macro definitions, and insert them in 
the program as programmer macro 
definitions, since the prcgrammer macro 
definitions are flagged inline. To aid in 
debugging it is advisable to test all macro 
definitions as programmer macro definitions 
before incorporating ther ina library as 
system macro definitions. 
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Programming Considerations 


This section consists of a number of 
discrete subjects about assembler language 
programming. 


Saving and Restoring General Register 
Contents 


A problem program should save the values 
contained in the general register upon 
commencing execution and, upon completion, 
restore to the general registers these same 
values. Thus, as control is passed from 
the operating system to a problem program 
and, in turn, to a subprogram, the status 
of the registers used by each program is 
preserved. This is done through use of the 
SAVE and RETURN system macro instructions. 


The SAVE macro instruction shculd be the 
first statement in the program. It stores 
the contents of register 14, 15, and 0 
through 12 in an area provided by the 
program that passes control. Whena 
problem program is given control, register 
13 points to an area in which the general 
register contents should be saved. 


If the program calls any subprcgrams, or 
uses any operating system services other 
than GETMAIN, FREEMAIN, ATTACH, and XCiIL, 
it must first save the contents of register 
13 and then load the address of an 18 
fullword save area into register 13. This 
Save area is in the proklem program and is 
used by any sukprograms or operating system 
services called by the problem program. 


At completion, the problem program 
restores the contents of general registers 
14, 15 and 0-12 by use of the RETURN system 
Macro instruction (which also indicates 
program completion). The contents cf 
register 13 must be restored before 
execution of the RETURN macro instruction. 
The coding sequence that follows 
illustrates the basic process of saving and 
restoring the register. A complete 
discussion of the SAVE and RETURN macro 
instructions and the saving and restoring 
of registers is contained in the OS Data 


Management Services Guide and OS Vata 
Management Macro Instructions publications. 
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osha accra 1. 
|Name | Operation | Ope rand | 
|-------- 4--~-------- 4-~----------------- -4 
| BEGIN | SAVE | (14,12) | 
| | - | | 
| ae | set up base register 
| | - | | 
| |} ST |] 13,SAVEBLK+4 | 
| | LA | 13,SAVEBLK | 
| | - | | 
| | - | | 
| | L {| 13,SAVEBLK+4 | 
| | RETURN | (14,12) | 
| SAVEBLK | DC | 18F°0* | 
cence pi Deane ear eens Mr ree ee es a = 


Program Termination 


Completion of an assembler source program 
is indicated by using the RETURN system 
macro instruction to pass control from the 
terminating program to the program that 
initiated it. The initiating prcgram may 
be the operating system or, if a subprogram 
issued the RETURN, the program that called 
it. 


In addition to indicating program 
completion and restoring registers, the 
RETURN macro instruction may also pass a 
return code -- a condition indicator that 
may be used by the program receiving 
control. If the return is to the operating 
system, the return code is compared against 
the condition stated in the COND= parameter 
of the JCB or EXEC statements. If return 
is to another problem program, the return 
code is available in general register 15, 
and may be used as desired. Register 13 
should be restored before issuing the 
RETURN macro instruction. 


The RETURN system macro instruction is 
discussed in detail in the OS Sufervisor 
Services and Macro Instructions 
publication. 


PARM Field Access 


Access to information in the PARM field of 
an EXEC statement is gained through general 
register 1. When control is given to the 
problem program, general register 1 
contains the address of a full word which, 
in turn, contains the address of the data 
area containing the information. 


The data area consists of a halfword 
containing the count (in binary) of the 
number of information characters, tollowed 


by the information field. The information 


field is aligned to a half-word boundary. 
The following diagram illustrates this 
process. 


General Register | 


Address of Full Word 
Points 


to Full Word 


Address of Data Area 


Data Area 


Information Field 











Macro Definition Library Additions 


Source statement coding, to be retrieved by 
the COPY assembler instruction, and macro 
definitions may be added to the macro 
library. The IEBUPDTE utility program is 
used for this purpose. Details cf this 
program and its control statements are 
contained in the OS Utilities publication. 
The following sequence of job control 
statements can be used to call the utility 
program and identify the needed data sets. 
It is assumed that the job contrcl 
statements, LEBUPDTE program control 
statements, and data are to enter the 
system via the input stream. 


Ve JOB 
/stepname EXEC PGM=IEBUPDTE, PARM=MOD 
//SYSUTI DD DSNAME=SYS1.MACLIB, DISP=OLD 
SYSUT2 DD DSNAME=SYS1.MACLIB, DISP=OLD 
/SYSPRINT DD SYSOUT=A 
//SYSIN “ 


DD 


IEBUPDTE control statements and source statements or 
macro-definitions to be added to the macro-library 


(SYS1.MACLIB) 


/* (delimiter statement) 


Load Module Modification - Entry Point 
Restatement 


If the editing functions of the linkage 
editor are to ke used to modify a lcad 
module, the entry point to the load module 
must be restated when the load module is 
reprocessed by the linkage editor. 
Otherwise, the first byte of the first 
control section processed by the linkage 


editor will become the entry point. To 
enable restatement of the original entry 
point, or designation of a new entry point, 
the entry point must have been identified 
originally as an external symbol, i.e., 
appeared as an entry in the external symkol 
dictionary. External symbol identification 
is done automatically by the assemkler if 
the entry point is the name of a control 
section or START statement; otherwise, an 
assembler ENTRY statement must be used to 
identify the entry point name as an 
external symkol. 


When a new object module is added to or 
replaces part of the load module, the entry 
point is restated in one of three ways: 


e By placing the entry point symbol in 
the operand field of an EXTRN statement 
and an END statement in the new object 
module. 


e By using an END statement in the new 
object module to designate a new okject 
module. 


e By uSing a linkage editor ENIRY 
statement to designate either the 
Original entry point or a new entry 
point for the load module. 


Further discussion of load module entry 
points is contained in the OS Loader and 
Linkage Editor publication. 


Object Module Linkage 


Object modules, whether Assembler-, 
FORTRAN-, or CCROL-generated, may ke 
combined by the linkage editor to produce a 
composite load module, provided each object 
module conforms to the data formats and 
linkage conventions required. This topic 
discusses the use of the CALL system macro 
instruction to link an assembler language 
"Main" program to subprograms produced ky 
FORTRAN and COBOL. ‘The OS Supervisor 
contains additional details concerning 
linkage conventions and the CALL system 
macro instruction. 


Figure 11 shows the statements used to 
establish the assembler program linkage to 
the called subprograms. 


If any input/output operations are 
rerformed by called subprograms, 
appropriate DD statements for the data sets 
used by the subprograms must be supplied. 
See the appropriate FCRTRAN IV Programmer's 
Guide publications for explanaticn of the 
CD statements used to describe data sets 
for FORTRAN programs and a description of 
the special FORTRAN data set reccrd 
| formats. The COBOL Programmer's Guide 
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publications provide DD statement 
information for COBOL programs. 


Dictionary Size and Source Statement 
Complexity 


This section descrikes the compositicn of 
the assembler dictionaries and their entry 
sizes, and describes methods for 
determining if the limits on source 
statement complexity will be exceeded. 


(14,12) 
set up base register 


13, SVAREA+4 
15,SVAREA 
15,8(13) 
13,15 


name, (V1,V2,V3),VL 


13, SVAREA+4 
(14,12) 

18F'0! 

(data) 

(data) 

(data) 


Dictionary entries, e.g.-, sequence 
symbol names, prototype symbolic 
parameters, vary in length. Therefore, the 


number of entries a dictionary can hold is 


determined by the types of entries. 


Source statement complexity -- the 
number of symbols, characters, cferators, 
delimiters, references to length 
attributes, self-defining terms, literals, 
and expressions appearing in a source 
statement -- determines whether cr not the 
source statement can be successfully 
processed. 


This is an example of OS linkage convention. See the publication OS Supervisor Services and Macro Instructions for details. 


The symbol used for "name" in this statement is: 


a, The name of a subroutine or function, when the linkage is to a FORTRAN-written subprogram. 


b. The name defined by the following COBOL statements in the procedure division: 


ENTER LINKAGE, ENTRY'name', 


¢. The name of a CSECT or START statement, or a name used in the operand field of an ENTRY statement in an assembler subprogram, 


The order in which the parameter list is written must reflect the order in which the called subprogram expects the argument. If the called routine is a 
FORTRAN-written function, the returned argument is not in the parameter list: a real or double precision function returns the value in floating point 


register zero; an integer function returns the value in general purpose register zero. 


CAUTION: When linking to FORTRAN-written subprograms, consideration must be given to the storage requirements of IBCOM (FORTRAN execution-time 
1/O and interrupt handling routines) which accompanies the compiled FORTRAN subprogram. In some instances the call for IBCOM is not automatically 
generated during the FORTRAN compilation. The OS FORTRAN IV Library publication provides information about IBCOM requirements and assembler 


statements used to call IBCOM. 


FORTRAN - written subprograms and FORTRAN library subprograms allow variable-length parameter lists in linkages which call them; therefore all linkages 
to FORTRAN subprograms are required to have the high-order bit in the last parameter in the linkage set to 1, COBOL-written subprograms have fixed- 
length calling linkages; therefore, for COBOL the high-order bit in the last parameter need not be set to 1. 


32, . : 
This statement reserves the save area needed by the called subprogram. When control is passed to the subprogram, register 13 contains the address of this 


area, 


456 When linking to a FORTRAN or COBOL subprogram, the data formats declared in these statements are determined by the data formats required by 


the FORTRAN or COBOL subprograms, 
Figure it. 


Linkage Statemenis 


30 





Dictionaries Used in Conditional Assembly 
and Macro Instruction Expansion 


To accomplish macro instruction expansion 
and conditional assembly, the assenrbler 
constructs a general dictionary consisting 
of two parts: one global dictionary for 
the entire program, and an area for all of 
the local dictionaries. 


The global dictionary contains one entry 
for each machine operation code, extended 
mnemonic operation code, assembler 
operation code, macro instruction, and 
global SET variakle symkol. 


The local dictionary area consists of 
one local dictionary for each different 
macro definition in the program, and one 
local dictionary for the main portion of 
the program (those statements not within a 
macro definition, also called “open code"). 
The contents of the local dictionaries are 
described in subsequent paragraphs. 


The capacity of the general dictionary 
(global dictionary and all local 
dictionaries) is up to 64 blocks of 1024 
bytes each. The division of the dictionary 
into global and local sections is done 
dynamically: as the global dicticnary 
becomes larger, it occupies Llocks taken 
from the local dictionary area. Thus, the 
global dictionary is always core resident. 
As it expands into the logical dictionary 
area, the local dictionaries may overflow 
onto a utility file. The size of the 
dictionaries in core depends upon core 
availability. The minimum core allocation 
is three blocks for the global dicticnary 
and two blocks for each local dictionary. 


Each block in the global and local 
dictionaries contains complete entries. 
Any entry not fitting into a block is 
placed in the next Llock; the renaining 
bytes in the current block are not used. 


The global and local dictionaries take 
two forms: one when the dictionary entries 
are collected, i.e., picked up during the 
initial scan of the source program, and one 
during the actual conditional asserbly and 
Macro generation, i.e., generation time. 
The following text describes the global and 
local dictionaries at both collection time 
amd generation time. 


Global Dictionary at Collection Time 


One global dictionary is built for the 
entire program. It contains machine 
operation codes, extended mnemonic 
operation codes, assembler operation codes, 
OPSYN defined operation codes, macro 
instruction mnemonics, and global SET 
variable symbols. One entry is made as 
shown in Figure 12. 













. ‘ kk 
Each machine operation code 5 bytes plus mnemonic* 
Each extended mnemonic operation 
ae 3 
code or assembler operation ** 6 bytes plus mnemonic* 
Each macro mnemonic operation code | 10 bytes plus mnemonic* 
7 bytes plus name* 


*One byte is used for each character in the name or mnemonic. 







Each global SET variable symbol 





**For the first two types of entries, a total of 
0780, . (1920, 9) bytes of core is required. 


Figure 12. Global Dictionary Entries at 
Collection Time 
Fixed overhead for this dictionary is: 


8 bytes for the first block 
4 bytes for each succeeding block 
5 bytes for the last block 


Local Dictionaries at Collection Time 


For the main portion of the program (those 
statements not within a macro definition), 
one local dictionary is constructed in 
which ordinary symbols, sequence symkols, 
and local SET variable symbols are entered. 
In addition, one local dictionary is 
constructed for each different macro 
definition in the program. These local 
dictionaries contain one entry for each 
local SET variable symbol, sequence symkol, 
and prototype symbolic parameter declared 
within the macro definition. If a sequence 
symbol is defined before it is referenced, 
an extra entry for the symbol is made. 
Figure 13 shows the size cf each type of 
entry. 


Each ordinary symbol 
appearing in the main portion 
of the program, 















10 bytes plus name* 





*One byte is used for each character in the name or mnemonic. 


Local Lictionary Entries at 
Collection Tire 


Figure 13. 


Fixed overhead for this dictionary is: 


8 bytes for the first block 
main program) 


(if in the 
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32 bytes for the first block (if ina 
macro definition) 
4 bytes for each succeeding block 
5 bytes for the last block 


Global Dictionary at Generation Time 


The sizes of the global dictionary entries 
at generation time are shown in Figure 14. 












Each macro mnemonic operation code 
Each global SETA symbol (dimensioned)| 2 bytes plus 4N™ 


Each global SETA symbol 
4 bytes ; 


(undimensioned) 

Each global SETB symbol (dimensioned) | 2 bytes plus (N/8)” (N/8 is 
rounded to the next highest 
integer) 


Each global SETB symbol "| 1 bit 
(undimensioned) 
Each global SETC symbol ‘ 
(dimensioned) 2 bytes plus 9N 
Each global SETC symbol 

9 bytes 


(undimensioned) 
Global Dictionary Entries at 
Generation Time 


















*N = dimension 
Figure 14. 


Fixed overhead for this dictionary is: 
4 bytes plus word alignment. 
Local Dictionaries at Generation Time 


Figure 15 shows the sizes of the various 
entries appearing in the local dictionaries 
at generation time. 
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Each local SETA symbol (dimensioned) | 2 bytes plus 4N* 


Each local SETA symbol 
4 bytes 


(undimensioned) 
2 bytes plus (N/8)* (N/8 is 
rounded to the next highest 
integer) 


Each local SETC symbol (dimensioned) 2 bytes plus 9N”* 


Each local SETC symbol 
9 bytes 


(undimensioned) 


Local Lictionary Entries at 
Generation Tire 


Each local SETB symbol (dimensioned) 


Each local SETB symbol 
(undimensioned) 


Each ordinary symbol 
appearing in the main portion 
of the program. ** 


*N=dimension 
**These entries appear only in the main 
program local dictionary. 


Figure 15. 


Fixed overhead for this dictionary is 
20 bytes plus word alignment. 


Additional Dictionary Requirements 


The generation time global dicticnary and 
the generation time local dictionary for 
the main portion of the program must be 
resident in main storage. 


In addition, if the prcegram ccntains any 
macro instructions, main storage is 
required for the largest local dictionary 
of the macro definitions being processed. 
Furthermore, during processing of macro 
definitions containing inner macro 
instructions, main storage is required for 
the generation time local dictionaries for 
the inner macro instructicns contained 
within the macro definition. 


In addition to those requirements 
specified for the local dictionary of the 
main portion of the program, each macro 
definition local dictionary requires space 
for entries shown in Figure 16. 


3 bytes plus L 


7 bytes plus L 


9 bytes plus L 
9 bytes plus 3N bytes plus Y 


Entry 
Each character string (1) 


Each hexadecimal, binary, decimal, 
and character self-defining term (2) 


Each symbol (3) 


Each sublist 





L = Length of entry in bytes 
N° = Number of entries in sublist 
Y SUby Eo bg tees E.. 
where E = size of an entry (formats 1,2, and 3 above) 
Figure 16. Macro Cefinition Local 


Dictionary Parameter Table 


Fixed overhead for the macro definition 
local dictionary parameter table is 22 
bytes. Each nested macro instruction also 
requires space in its local dictionary for 
the following: 


8 bytes rflus 2N 
(N = the number 
of operands) 


Parameter pointer list 


8 bytes plus 
word alignment 


Pointers to parameter 
pointer list and 
parameter table 


Correction of CLictionary Overflow 


If an assembly is terminated at ccllection 
time with either a GLOBAL DICTIONARY FULL 
message (1EU053) or a LOCAL DICTIONARY FULL 
message (ILEU054), the programmer can take 
one or more of the following sters: 

1. Split the assembly into two cr more 
parts and assemble each separately. 
2. Allocate more main storage fcr the 
assembler (the global and lccal 
dictionaries together can occupy up 
64K). 


to 


Specify a smaller SYSLIB blccksize. 
Thus, if BLKSIZE=3600, try PLKSIZE= 
1800 or BLKSIZE=1200, reblock the 
library to the size chosen, and try 
the assembly again. 


Specify a smaller blocksize for the 
utility files SYSUT1, 2, and 3. The 
minimum blocksize normally used by the 
aSsembler is 1700 bytes. Reduce this 
by specifying DCB=BLKSIZE=n cn the 
SYSUT1 DD card. SYSUT2 and 3 use the 
same blocksize as SYSUT1. 


If the assembly is terminated at 
generation time with a GENERATION TIME 
CICTIONARY AREA OVERFLOWED message 


(IEU068) , the programmer should allocate 
more main storage to the assembler and 
re-assemble his program. If he cannot 
allocate more main storage to the 
assembler, the programmer should split the 
assembly into two or more parts and 
assemble each separately. 


Symbol Table Overflow 


Assembler performance can degrade when the 
source text plus macro-generated statements 
contains many ordinary symbols. If there 
are more ordinary symbols than will fit in 
the symbol table, the assembler will make 
one or more additional passes over the 
text. No symbols will be lost, rut 
assembly time will increase. 


In general, the assembler can handle 400 
ordinary symbols without overflow in its 
minimum main storage (see Figure 3). 
Because Of input and/or output Llocking 
differences, the minimum amount of main 
storage varies. It is approximately 49,00 
bytes for MFT, and 51,000 bytes for MVT. 
The assembler can process one additional 
symbol for each 18 bytes above the minimum 
amount of main storage. 


Source Statement Complexity 


The complexity of a source statement is 
limited both by the macro generator and the 
assembler portions of the assembler. The 
following topics provide the information 
necessary to determine if 
statement-complexity limitations for either 
portion of the assembler are being 
exceeded. 


ES a 


For any statement which 
1. Is a conditional assembly statement, 
2. Is a DC or DS statement, 
3. Is an EXTRN or WXTRN statement, 
4. Contains a sequence symbol cr a 
variable symbol, 
5. Is not a macro instruction cr 


prototype statement, 
the total number of explicit occurrences of 
1. Ordinary symbols (includes machine 
Mnemonics, assembler mnemonics, 


conditional assembly mnemonics, and 
macro instruction mnemonics) , 
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2. Variable symbols, 
3. Sequence symbols, 


must not exceed 50 for the entire 
Statement. 


For macro instructions and prctoctyrpe 
statements the number of occurrences of 
ordinary symbols, variable symbols, and 
sequence symbols must not exceed 50 in the 
name and operation fields combined; or in 
each operand unless the operand is a 
sublist, in which case the limit is applied 
to each sublist operand. In any operand if 
a character string has the same form as a 
symbol, it is counted as a symbol. 


Examples of Counts: 


&B2 SETB (T'NAME EQ 'W’) count=3 (&B2,SETB, NAME) 
EXTRN A,B,C, &C count=5 (EXTRN,A,B,C, &C) 


Assembler Portion Limitations 


1. Generated statements may not exceed 
236 characters. Statement length 
includes name, operation, oferand, and 
comments. If a comments field exists, 
the blank separating the operand and 
comments field is included in the 
statement length. The statement is 
truncated if it exceeds 236 
characters. 


2. DC, DS, DXD, and literal DCs cannot 
contain more than 32 operands per 
statement. 


System/S3S60 Model 91 Programming 
Considerations 


The assembly language programmer shculd be 
aware of the operational differences 
between the Model 91 and other Systen/360 
models. The Model 91 requires a simulation 
routine to execute most decimal 
instructions and it yields different 
floating-point instructions executicn 
results. The Model 91 also decodes and 
executes instructions concurrently. 


These and other coding and tining 
considerations are discussed in detail in 
IBM System/360 Model 91 Functional 
Characteristics, Order No. GA22-6907. 
Additional information on how to control 
sequential and nonsequential instruction 
execution is given below. 


Controlling Instruction Execution Sequence 


The CPU maintains a logical consistency 
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including the beginning and ending of 1/0 
operations, but it does not assume 
responsibility for such consistency in the 
operations performed by asynchronous units. 
Consequently, for any asynchronous unit 
that depends upon a strict adherence to 
sequential (or serial) execution, a proklem 
program must set up its own procedures to 
ensure the proper instructions sequence. 


For a program section that requires the 
serial or sequential execution of 
instructions, the following 'no-cperation' 
instruction: 

BCR M,0 where M # 0 
causes the instruction decoder tc halt, and 
the instructions that have already been 
decoded to be executed. (This action is 
called a pipe-line drain.) On the Model 
91, this instruction ensures that all the 
instructions preceding it are executed 
before the instruction succeeding it is 
decoded. Use of this instruction should te 
minimized since it may affect the 
performance of the Model 91. 


Isolating an instruction by preceding it 
and succeeding it with a BCR instruction 
eliminates multiple imprecise interruptions 
from more than one instruction by virtue of 
the pipe-line drain effect. However, since 
multiple exceptions may occur in'one 
instruction, this technique does not 
eliminate a multiple imprecise interruption 
nor does it change an imprecise 
interruption into a precise interruption. 
The use of the BCR instruction dces not 
assure a programmer that he can fix up an 
error Situation. In general, the only 
information available will be the address 
of the BCR instruction. The length of the 
instruction preceding the BCR instruction 
is not recorded, and generally there is no 
way to determine what that instruction is. 


System/360 Model 85 Prograniming 


Considerations 


The Model 85 has two special features 
available to the assembler language 
programmer. They are extended-precision 
(two doubleword) floating point 
instructions and byte-oriented (unaligned) 
operands. Detailed information on these 
features is in the IBM System/360 
Principles of Operation manual, 
GA22-6821. 


rder No. 


Assembler F supports these features with 
mnemonic operation codes for the 
extended-precision instructions, a two 
doubleword data constant ([£C), an option 
for suppressing the alignment error 
message, and an assembler instruction for 
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EXTENDED FLOATING POINT NUMBER (L) 


7 BIT 
CHARAC 


TERISTIC 


HIGH ORDER HALF OF 
112 BIT FRACTION 








Figure 17. Extended-Precision Floating 


Point Format 


These assembler features are explained in 
the following paragraphs. 


Extended-Precision Machine Instructions 


The extended-precision arithmetic 
instructions and the rounding instructions 
of the Model 85 are shown in Figure 18. 

The data format for extended operands of 
the AXR, SXR, MXR, and LRDR instructions 
and for extended results of the AXR, SXR, 
MXR, MXCR, and MXD instructions is shown in 
Figure 17. A complete description of these 
instructions is in the Principles cf 
Operation manual. 


Simulator 


A program containing extended- precision 
arithmetic and rounding instructicns can be 
executed on a model that does not have 
these instructions using the 

extended- precision floating- point simulator 
routine of the supervisor. The rcutine 

is accessed through the user's program 
interrupt handler. The user must supply a 
SPIE macro instruction and a routine to 
transfer control to the simulator routine. 
This is explained in detail under "Extended 
Precision Floating-Point Simulaticn" in OS 


Supervisor Services and Macro Instructions. 


There are two versions of the simulator. 
For machines that support the instructions 
listed in Figure 18, a simulation routine 
for an extended-precision divide cperation 
is available. The other version is 
intended for other System/360 models. it 
Simulates the instructions listed in Figure 
18 as well as the divide operation. 


Because the assembler does not recognize 
any Operation code for an 
extended-precision divide instruction, a 
supervisor macro instruction has been 
provided to produce the proper machine 
language for the simulator. The fcrmat of 
that macro is described under "DXR" in OS 


Supervisor Services _and Macro Instructions. 


LOW ORDER HALF OF : 
112 BIT FRACTION 
8 : 63 


ADD NORMALIZED (extended operands, 
extended result) 

SUBTRACT NORMALIZED (extended 
operands, extended result) 

MULTIPLY (extended operands, 


extended result) 
MULTIPLY (long operands, 
extended result) 
MULTIPLY (long operands, 
extended result} 
LOAD ROUNDED (extended to long) 
LOAD ROUNDED (long to short) 





Extended-Precision and Rounding 
Instructions 


Figure 18. 


Approximating Extended-Precision Floating 
Point Instructions 

An eaSier way to debug a program containing 
extended-precision floating-point 
instructions on a machine that dces not 
contain these instructions, is to 
approximate them to long floating-point 
instructions. This is done with the OFSYN 
assembler instruction. 


For example, to “equate” MXR in a source 
program to MDR, the following instruction 
is placed at the beginning of the program: 


MXR OPSYN MDR REPLACE ALL MXR OPERATIONS 
WITH MCR 


The MDR instruction is then assemkled for 
each occurrence of the MXR instruction in 
the source module. The program can be run 
and debugged on a model that does not have 
the MXR instruction. Later, the programmer 
can remove the OCPSYN statement and run his 
program on a machine that supports MXR. 


The Module 85 will execute unprivileged RX- 
and RS- format instructions with fixed 
point, floating-point, or logical operands 
that are not on integral boundaries. 
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Assembly of such instructions norrally 
produces the diagnostic message “ILEU033 
Alignment Error". A new PARM option in the 
EXEC statement for the Assembler F, ALGN or 
NOALGN, makes it possible to suprress the 
message and thereby obtain a “clean" 
assembly listing. The object code is not 
affected. 


Note that an assembled progran that 
requires use of the Lyte-oriented crerand 
feature must be run on a Model 85 or 195 
machine. Further, it cannot run 
successfully under the Operating System if 
it violates any alignment restrictions 
imposed by OS. 


Type L Data Constant 


A Define Constant (DC) operand type, L, has 
been added to provide extended- precision 
floating-point constants for the 
programmer. It can be used as a Define 
Storage ([S) operand or ina literal. 
Unless changed by a length modifier, the 
type L constant is 16 bytes long and is 
aligned on a doubleword boundary. Its 
format is that of two contiguous type D 
constants, as shown in Figure 17, except 
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that it is assembled with the sign of the 
second doubleword equal to that of the 
first, and the characteristic of the second 
equal to that of the first minus 14, modulo 
128. 


Model 195 and System/ 370 Programming 


Considerations 


The Model 195 and the System/370 machines 
have the following special features: 
extended-precision (two doubleword) 
floating-point instructions and 
byte-oriented (unaligned) operands. The 
previous descriptions of these features 
under “System/360 Model 91 Programming 
Considerations" and "“System/360 Model 85 
Programming Considerations" also apply to 
the Model 195 and to System/370 machines. 
Detailed information can be found in IBM 
System/360 Model _ 195 Functional 


SP Se 


Characteristics, Order No. GA22-6943 and 


in IBM System/370 Principles of Operation, 
Order No. GA22-7000. 


Note: ‘The Model 195 does not need the 
decimal simulator routine used Ly the Model 
91. 





Appendix A. Diagnostic Messages 


This section explains the messages issued by the assembler. They are written on SYSPRINT (if option 
LIST is in effect) and on SYSTERM (if option TERM is in effect). Messages with serial numbers over 
900 are also produced on the operator ccnscle. 


Message Format 


On SYSPRINT: XX IEUnnn text (See Figure 10.) 
On SYSTERM: IEUnnn text (See Appendix E.) 
On operator console: IEUnnnl text 
XX Statement number for statement in error 
nnn Message serial number. For messages with serial number over 900, the number is followed by 
the character I. 
text Message text 


Severity Codes 


The severity code indicates the effect cf an errer on the execution of a program being assembled: 


* Informational message; no effect on execution 

0 Informational message; normal execution is expected 

4 Warning message; successful execution is probable 

8 Error; execution may fail 

12 Serious error; successful execution is improbable 

16 Critical error; successful execution is impossible 

20 Assembler program terminated abnormally 

IEU001 CUPLICATION FACTOR ERROR copy of the PLS member specified in the 


COPY statement. 
Explanation: A duplication factcr is not 
an absolute expression, or is zerc ina 
literal; * in duplication factor IFU003 LENGTH ERROR 
expression; invalid syntax in expression. 
Explanation: The length specification is 


Severity Code: 12 out of permissible range cr specified 

invalidly; * in length expression; invalid 

Programmer Response: Probable user error. syntax in expression; no left-parenthesis 

Make sure the source code iS correct and delimiter for expressicn. 

reassemble if necessary. If the prceblem 

recurs, do the following before calling Severity Code: 12 

IBM: 

e Have the user source program, user macro Programmer Response: Make sure the source 
definitions, and associated listing code is correct and reassemble if 
available. necessary. If the proklem recurs, do the 

e If the COPY statement was used, execute following before calling IEM: 
the IEBPTPCH utility program to obtain a e Have the user source prcgram, user macro 
copy of the PDS member specified in the definitions and associated listing 
COPY statement. available. 


e If the CCFY statement was used, execute 
the IEEPTFCH utility program to oktain a 
IEU002 RELOCATABLE DUPLICATION FACTOR copy of the PDS member specified in the 
COFY statement. 
Explanation: A relocatable expression has 
been used to specify the duplication 


factor. IEU004 RELCCATABLE LENGTH 
Severity Code: 12 Explanation: A relocatable expression has 


been used to specify length. 
Programmer Response: Make sure the source 


code is correct and reassemble if Severity Code: 12 

necessary. If the problem recurs, dc the 

following before calling IbM: Programmer Response: Make sure the source 

e Have the user source program, user macro code is correct and reassemble if 
definitions and associated listing necessary. If the proklem recurs, do the 
available. following before calling IBM: 

e If the COPY statement was used, execute e Have the user source program, user macro 
the IFBPTPCH utility program tc cbtain a definitions and associated listing 
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IEU005 


IEU006 


LEU007 
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available. 

e If the COPY statement was S Aiseay execute 
the IFBPTPCH utility program tc obtain a 
copy of the PDS memker specified in the 
COPY statement. 


S-TYPE CONSTANT IN LITERAL 


Explanation: An S-type address constant 
May not be specified in a literal. 


Severity Code: 8 


Programmer Response: Make sure the source 
code is correct and reassemble if 


necessary. I1f the problem recurs, 

following before calling IBM: 

e Have the user source program, user macro 
definitions and associated listing 
available. 

* If the COPY statement was used, execute 
the IEBPTPCH utility program tc cbtain a 
copy of the PDS membe r specified in the 
COPY statement. 


do the 


INVALID ORIGIN 


Explanation: The location counter has been 
reset to a value less than the starting 
address of the control section; ORG cperand 
is not a simply relocatable expression or 
specifies an address outside the ccntrol 


_ section. 


Severity Code: 12 


Programmer Response: Make sure the source 
code is correct and reassemble if 
necessary. I1f the problem recurs, 
following before calling IBM: 

e Have the user source program, user macro 
definitions and associated listing 
available. 

e If the COPY statement was used, execute 
the IEFBPTPCH utility program tc obtain a 
copy of the PDS member specified in the 
COPY statement. 


dc the 


LOCATION COUNTER ERROR 


Explanation: Either the location ccunter 
has exceeded 22%-1, or passed out cf 
control section in negative direction (3 
byte arithmetic). 


Severity Code: 12 
Programmer Response: Make sure the source 


code is correct and reassemble if 

necessary. If the problem recurs, 

following before calling IBM: 

e Have the user source program, user macro 
definitions and associated listing 
available. 

e If the COPY statement was used, execute 
the IEBPTPCH utility program to obtain a 
copy of the PDS memker specified in the 


COPY st avement ° 


do the 


LEU008 


LEU009 


IFU010. 


1£U011 


"Programmer Response: 


INVALID DISPLACEMENT 


nation The displacement in an 

Sapricie Sadcees is not an absolute value 

within the range of 0 to 4095. 

Severity Code: 8 

Make sure the source 

code is correct and reassemble if 

necessary. If the problem recurs, do the 
following before calling IBM: 

e Have the user source prcgram, user macro 
definitions and associated listing 
available. 

e If the COPY statement was used, execute 
the IEBPTECH utility program to oktain a 
copy of the FLS member specified in the 
COPY statement. 


MISSING OPERAND 


Explanation: Statement requires an operand 
entry and none is present. 


Severity Code: 12 

Programmer Response: Make sure the source 

code is correct and reassemble if 

necessary. If the problem recurs, do the 
following before calling IEM: 

e Have the user source pregram, user macro 
definitions and associated listing 
available. 

e If the COPY statement was used, execute 
the IEBPTECH utility program to oktain a 
copy of the PDS member specified in the 
CCFY statement. 


INCCRRECT SEECIFICATION OF REGISTER OR MASK 


nation One of the following: 
Site Eon oe or wask field specification 
is not an absolute value. 

e The register or mask field specified is 

. not in the range 0.- 15. 

e An odd register is specified where an 
even register is required (applies to 
multiply, divide and shift instructions). 

e The register specified is not a floating 
point register (applies to Shoeet point 
instructions) . 

e The register specified is not an extended 
precision floating point register 
(applies to extended precision floating 
point instructions). 


Severity Code: 8 
Programmer Response: Make sure the source 
code is correct and reassemble if 
necessary. If the problem recurs, do the 
following before calling IEM: 

e Have the user source pregram, user macro 
definitions and associated listing 
available. 

e If the CCFY statement was used, execute 
the IEBPTPCH utility program to obtain a 
copy of the PLS member specified in the 
CCFY statement. 


SCALE MODIFIER ERROR 


Explanation: The scale mcdifier is not an 
absolute expression or is tco large, 
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IEU012 


IEUO 13 


LEU014 


* in scale modifier expression; invalid 
syntax or illegally specified scale 
modifier. 


Severity Code: 8 


Programmer Response: Make sure the source 
code is correct and reassemble if 
necessary. If the problem recurs, 
following before calling IBM: 

e Have the user source program, user macro 
definitions and associated listing 
available. 

e If the COPY statement was used, execute 
the IEBPTPCH utility program to obtain a 
copy of the PDS member specified in the 
COPY statement. 


do the 


RELOCATABLE SCALE MODIFIER 


Explanation: A relocatable expression has 
been used to specify the scale modifier. 


Severity Code: 8 


Programmer Response: Make sure the source 
code is correct and reassemble if 


necessary. If the problem recurs, 

following before calling IBM: 

e Have the user source program, user macro 
definitions and associated listing 
available. 

e If the COPY statement was used, execute 
the IEBPTPCH utility program to obtain a 
copy of the PDS member specified in the 
COPY statement. 


do the 


EXPONENT MODIFIER ERROR 


Explanation: The exponent is not specified 
as an absolute expression or is out of 
range; * in exponent modifier expression; 
invalid syntax; illegally specified 
exponent modifier. 


Severity Code: 8 


Programmer Response: Make sure the source 
code is correct and reassemble if 
necessary. If the problem recurs, do the 
following before calling IBM: 

e Have the user source program, user macro 
definitions and associated listing 
available. 

e If the COPY statement was used, execute 
the IEBPTPCH utility program to obtain a 
copy of the PDS member specified in the 
COPY statement. 


RELOCATABLE EXPONENT MODIFIER 


Explanation: A relocatable expression has 
been used to specify the exponent modifier. 


Severity Code: 8 


Programmer Response: Make sure the source 

code is correct and reassemble if 

necessary. If the problem recurs, 

following before calling IBM: 

e Have the user source program, user macro 
definitions and associated listing 


do the 


IEU015 


IEU016 


available. 

e If the COPY statement was used, execute 
the IEBPTPCH utility program to oktain a 
copy of the PDS member specified in the 
COPY statement. 


INVALID LITERAL USAGE 


Explanation: A valid literal is used 
illegally, e.g., it specifies a receiving 
field or a register, or it is a Q-type 
constant. 


Severity Code: 8 


vrogrammer Response: Make sure the source 
code is correct and reassemble if 


necessary. If the problem recurs, do the 

following before calling IBM: 

e Have the user source program, user macro 
definitions and associated listing 
available. 

e If the COPY statement was used, execute 
the IEBPTPCH utility program to obtain a 
copy of the PDS member specified in the 
COPY statement. 


INVALID NAME 


Explanation: A name entry is incorrectly 


._ specified, e.g., it contains more than 8 


IEU017 


characters, it does not begin witha 

letter, it has a special character 
embedded, or -- if the statement is OPSYN 
~~ the name entry is not an ordinary symbol 
or is an assembler operation mnemonic. ; 


Severity Code: 8 


Programmer Response: Make sure the source 
code is correct and reassemble if 
necessary. If the problem recurs, do the 
following before calling IBM: 

e Have the user source program, user macro 
definitions and associated listing 
available. 

e If the COPY statement was used, execute 
the IEBPTPCH utility program to obtain a 
copy of the PDS member specified in the 
COPY statement. 


DATA ITEM TOO LARGE 


Explanation: The constant is too large for 
the data type or for the explicit length; 
operand field for packed [C exceeds 31 
characters and for zoned DC exceeds 16 
characters (excluding decimal points). 


Severity Code: 8 


Programmer Response: Make sure the source 
code is correct and reassemble if 
necessary. If the problem recurs, do the 
following before calling IBM: 

e Have the user source program, user macro 
definitions and associated listing 
available. 

e If the COPY statement was used, execute 
the IEBPTPCH utility program to oktain a 
copy of the PDS member specified in the 
COPY statement. 
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IEUO 18 


IEU019 


IEUO 20 
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INVALIE SYMBOL 


Explanation: The symbol is specified 
invalidly, e.g., it is longer than 8 
characters, or -- if the statement is OPSYN 
-- the name entry is not an ordinary symbol 
cr is an assembler operation mnemonic. 


Severity Code: 8 


Programmer Response: Make sure the source 
code is correct and reassemble if 
necessary. If the problem recurs, do the 
following before calling IBM: 

e Have the user source program, user macro 
definitions and associated listing 
available. 

e If the COPY statement was used, execute 
the LEBPTPCH utility program to obtain a 
copy of the PDS memker specified in the 
COPY statement. 


EXTERNAL SYMBOL ERROR 


Explanation: One of the following: 

® A symbol appears in the name field of 
both a CSECT and a DSECT statement. 

¢ A symbol appearing the name field cf a 
DXD instruction also appears in the name 
field of another PXD instructicn, in the 
operand field of an EXTRN of WXTIRN 
instruction, or in the name field cf a 
CSECT or [SECT statement. 

¢ A symbol appearing the operand field of 
an EXTRN or WXTRN instruction alsc 
appears in the operand field of the same 
or another EXTRN or WXTRN instruction, or 
in the name field of a DXD, CSECT, or 
CSECT instruction. 

e A symbol previously encountered in the 
name field of a statement cther than 
those mentioned akove, appears in the 
operand field of an EXTRN or WXTRN 
instruction or in the name field of a 
DXD, CSECT, or DSECT instruction. 


Severity Code: 8 


Programmer Response: Make sure the source 
code is correct and reassemble if 
necessary. If the problem recurs, 
following before calling IBM: 

« Have the user source program, user macro 
definitions and associated listing 
available. 

e If the COPY statement was used, execute 
the IEBPTPCH utility program tc obtain a 
copy of the PDS member specified in the 
COPY statement. 


dc the 


INVALIC IMMELCIATE FIELD 


Explanation: The value of the innediate 
operand exceeds 255 (or 9 for SRF) or the 
operand is not of an acceptable tyre. 


Severity Code: 8 
Programmer Response: Make sure the source 


code is correct and reassemble if 
necessary. If the problem recurs, 
following before calling IBM: 

° Have the user source ena 


do the 


user macro 


available. 


1EU021 


IFU022 


LEU0 23 


IEU024 


e If the COPY statement was used, execute 
the IEBPTFCH utility program to oktain a 
copy of the PDS nember specified in the 
COPY statement. 


SYMBOL NOT PREVIOUSLY DEFINED 


Explanation: An expression requiring that 
all symbols be previously defined contains 
at least one symbol not sc defined. 


Severity Code: 8 


Programmer Response: Make sure the source 


code is correct and reassemkle if 

necessary. 1f the problem recurs, do the 

eoT owas before calling IEM: 
Have the user source prcgram, user macro 
definitions and associated listing 
available. 

e If the CCFY statement was used, execute 
the IEBPTFCH utility program to oktain a 
copy of the PDS member specified in the 
CCFY statement. 


ESDTABLE OVERFLOW 


Explanation: The combined numker of 
control sections and dummy sections plus 
the number of unique symbcls in EXTRN and 
WXTRN statements and V-type constants 
exceeds 255. (A CSECT which appears as XD 
makes two entries). 


Severity Code: 12 


Programmer Response: Make sure the source 


code is correct and reassemkle if 

necessary. If the problem recurs, do the 

following before calling IEM: 

e Have the user source prcgram, user macro 
definitions and associated listing 
available. 

e If the COPY statement was used, execute 
the IEBPTFCH utility program to oktain a 
copy of the PIS member specified in the 
COPY statement. 


PREVIOUSLY DEFINED NAME 


nation The symbol which appears in 
aoa name field has appeared in the name 
field of a previous statement. 


Severity Code: 8 


er Response Make sure the source 
code is correct and. reassemble if 
necessary. If the problem recurs, 
following before calling IBM: 

e Have the user source prcegram, user macro 
definitions and associated listing 
availakle. 

e If the CCPY statement was used, execute 
the IEBPTPCH utility prcgram to obtain a 
copy of the PES member specified in the 
CCFY statement. 


do the 


UNDEFINED SYMEOL 


Explanation: A symbol being referenced has 
not been defined in the program. 


IEUO025 


IEU026 


IEU027 


Severity Code: 8 


Programmer Response: Make sure the source 


code is correct and reassemble if IEU028 

necessary. If the problem recurs, do the 

following before calling IBM: 

e Have the user source program, user macro 
definitions and associated listing 
available. 

e If the COPY statement was used, execute 
the IEBPTPCH utility program to obtain a 
copy of the PDS member specified in the 
COPY statement. 

RELOCATABILITY ERROR 

Explanation: A relocatable or complex 

relocatable expression is specified where 

an absolute expression is required, an 

absolute expression or complex relocatable 

expression is specified where a relocatable 
expression is required, or a relocatable IEU029 
term is involved in multiplication or 

division. 

Severity Code: 8 

Programmer Response: Make sure the source 

code is correct and reassemble if 

necessary. If the problem recurs, do the 

following before calling IBM: 

e Have the user source program, user macro 
definitions and associated listing 
available. 

e® If the COPY statement was used, execute 
the IEBPTPCH utility program tc obtain a 
copy of the PDS member specified in the 
COPY statement. 

TOO MANY LEVELS OF PARENTHESES 

IEU030 

Explanation: An expression specifies more 

than 5 levels of parentheses. 

Severity code: 12 

Programmer Response: Make sure the source | 

code is correct and reassemble if 

necessary. If the problem recurs, do the 

foi towing before calling IBM: 

Have the user source program, user macro 
definitions and associated listing 
available. 

e If the COPY statement was used, execute 
the IEBPTPCH utility program tc obtain a 
copy of the PDS member specified in the 
COPY statement. 

TOO MANY TERMS 

Explanation: More than 16 terms are IEU031 


specified in an expression. 


Severity Code: 12 
Programmer Response: Make sure the source 
code is correct and reassemble if 
necessary. If the problem recurs, do the 
eoreoueng before calling IBM: 
Have the user source program, user macro 
definitions and associated listing 
available. 
e If the COPY statement was used, execute 
the LEBPTPCH utility program to obtain a 
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copy of the PDS member specified in the 
COPY statement. 


REGISTER NOT USED 


Explanation: A register specified in a 
DROP statement is not currently in use. 


Severity Code: 4 


Programmer Response: Make sure the source 
code is correct and reassemble if 
necessary. If the problem recurs, do the 
sor LOWS before calling IBM: 
Have the user source program, user macro 
definitions and associated listing 
available. 

e If the COPY statement was used, execute 
the IEBPTPCH utility program to obtain a 
copy of the PDS member specified in the 
COPY statement. 





CCW ERROR 


Explanation: Bits 37-39 of the CCW are set 


to non-zero. 


Severity Code: 8 


Programmer Response: Make sure the source 
code is correct and reassemble if 
necessary. If the problem recurs, 
following before calling IBM: 

e Have the user source program, user macro 
definitions and associated listing 
available. 

e If the COPY statement was used, execute 
the IEBPTPCH utility program to oktain a 
copy of the PDS member specified in the 
COPY statement. 


do the 


INVALID CNOP 


Explanation: An invalid combination of 
operands is specified in a CNOP 
instruction. 


Severity Code: 12 

Programmer Response: Make sure the source 

code is correct and reassemble if 

necessary. If the problem recurs, 
following before calling IBM: 

e Have the user source program, user macro 
definitions and associated listing 
available. 

e If the COPY statement was used, execute 
the IEBPTPCH utility program to oktain a 
copy of the PDS member specified in the 
COPY statement. 


do the 


UNKNOWN TYPE 


Explanation: Incorrect type designation is 
specified in a DC, DS, or literal. If the 
DOS option is specified, type 9 will be 
flagged as unknown. 


Severity Code: 8 


Programmer Response: Make sure the source 
code is correct and reassemble if 
necessary. If the problem recurs, do the 
following before calling IBM: 

e Have the user source program, user macro 
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1EU032 


1EU033 


IEU034 
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definitions and associated listing 
available. 

e If the COPY statement was used, execute 
the LEBPTPCH utility program to obtain a 
copy of the PDS member specified in the 
COPY statement. 


OP-CODE NOT ALLOWED TO BE GENERATED 


Explanation: Operation code not allowed if 
source statement has been obtained through 
substitution of a value for a variable 
symbol. 


Severity Code: 8 


Programmer Response: Make sure the source 
code is correct and reassemble if 
necessary. If the problem recurs, do the 
following before calling IBM: 

e Have the user source program, user macro 
definitions and associated listing 
available. 

e If the COPY statement was used, execute 
the LEBPTPCH utility program to obtain a 
copy of the PDS member specified in the 
COPY statement. 


ALIGNMENT ERROR 


Explanation: Referenced address is not 
aligned to the proper boundary for this 
instruction, e.g., the location of the 
START operand is not a multiple of 8. 
Note: If a register is explicitly 
specified in the reference, e.g., as in 
L 3,3 (REG4), no message is issued. 


Severity Code: 4 


Programmer Response: Make sure the source 
code is correct and reassemble if 
necessary. If the problem recurs, do the 
foilowing before cailing IBM: 

e Have the user source program, user macro 
definitions and associated listing 
available. 

e If the COPY statement was used, execute 
the IEBPTPCH utility program to obtain a 
copy of the PDS member specified in the 
COPY statement. 


INVALID OP-CODE 


Explanation: Syntax error, e.g., more than 
8 characters in operation field, not 
followed by blank on first card image, orf 
code missing. 


Severity Code: 8 


Programmer Response: Make sure the source 
code is correct and reassemble if 
necessary. If the problem recurs, do the 
following before calling IBM: 

e Have the user source program, user macro 
definitions and associated listing 
available. 

e If the COPY statement was used, execute 
the IEBPTPCH utility program to obtain a 
copy of the PDS member specified in the 
COPY statement. 


IEU035 


IEU036 


IEU037 


LEUO38 
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‘Programmer Response: 


ADDRESSABILITY ERROR 


Explanation: The referenced address does 
not fall within the range of a USING 
instruction. 


Severity Code: 8 


Programmer Response: Probakle user error. 
Make sure the source code is correct and 
reassemble if necessary. If the problem 
recurs, do the following before calling 
IBM: 

e Have the user source program, user macro 
definitions, and associated listings 
available. 

e If the COPY statement was used, execute 
the IEBPTPCH utility program to obtain a 
copy of the PDS member specified in the 
COPY statement. 


(No message is assigned to this numcer) 
MNOTE STATEMENT 


Explanation: This indicates that an MNOTE 
statement has been generated from a macro 
definition. The text and severity code of 
the MNOTE statement will be found in line 
in the listing. 
Severity Code: Variable 

Programmer Response: Probakle user error. 

Make sure the source code is correct and 

reassemble if necessary. If the problem 

recurs, do the following kefore calling 

IBM: 

¢ Have the user source program, user macro 
definitions, and associated listings 
available. 

e If the COPY statement was used, execute 
the IEBPTPCH utility program to obtain a 
copy of the PLCS member specified in the 
COPY statement. 


ENTRY ERROR 


Explanation: A symbol in the operand of an 
ENTRY statement appears in more than one 
ENTRY statement, it is undefined, it is 
defined in a dummy section or in a blank 
common control section, or it is equated to 
a symbol defined by an EXTRN or WXTRN 
statement. 


Severity Code: 8 


Make sure the source 
code is correct and reassemble if 
necessary. If the problem recurs, do the 
following before calling IBM: 

e Have the user source program, user macro 
definitions and associated listing 
available. 

e If the COPY statement was used, execute 
the IEBPTPCH utility program to obtain a 
copy of the PDS member specified in the 
COPY statement. 


INVALID DELIMITER 
Explanation: This message can be caused by 


any syntax error, e.g., missing delimiter, 
special character used which is nota 


ILEU040 


LEUO41 
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valid delimiter, delimiter used illegally, 
operand missing, i.e., nothing between 
delimiters, unpaired parentheses, embedded 
blank in expression. 


Severity Code: 12 


Programmer Response: Make sure the source 
code is correct and reassemble if 
necessary. If the problem recurs, do the 
sol rowtng before calling IBM: 
Have the user source program, user macro 
definitions and associated listing 
available. 

e If the COPY statement was used, execute 
the IEBPTPCH utility program tc obtain a 
copy of the PDS member specified in the 
COPY statement. 


STATEMENT IS TOO LONG 


Explanation: There are more than 236 
characters in a generated statement. 


Severity Code: 12 


Programmer Response: Make sure the source 
code is correct and reassemble if 
necessary. If the problem recurs, 
following before calling IBM: 

e Have the user source program, user macro 
definitions and associated listing 
available. 

e If the COPY statement was used, execute 
the IEBPTPCH utility program to obtaina 
copy of the PDS member specified in the 
COPY statement. 


do the 


UNDECLARED VARIABLE SYMBOL 


Explanation: Variable symbol is not 
declared in a define SET symbol statement 
or ina macro prototype. 


Severity Code: 8 


Programmer Response: Make sure the source 
code is correct and reassemble if 
necessary. If the problem recurs, 
fol towsng before calling IBM: 
Have the user source program, user macro 
definitions and associated listing 
available. 

e If the COPY statement was used, execute 
the LEBPTPCH utility program to obtain a 
copy of the PDS member specified in the 
COPY statement. 


do the 


SINGLE TERM LOGICAL EXPRESSION IS NOT A 
SETB SYMBOL 


Explanation: The single term logical 
expression has not been declared as a SETB 
symbol. 


Severity Code: 8 


Programmer Response: Make sure the source 

code is correct and reassemble if 

necessary. If the problem recurs, 

following before calling IBM: 

e Have the user source program, user macro 
definitions and associated listing 
available. 


do the 


IEU043 
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IEUO4S 
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Explanation: 
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e If the COPY statement was used, execute 
the IEBPTPCH utility program to obtain a 
copy of the PDS member specified in the 
COPY statement. 


SET SYMBOL PREVIOUSLY DEFINED 


Severity Code: 8 


Programmer Response: Make sure the source 
code is correct and reassemble if 
necessary. If the problem recurs, do the 
sohrowang before calling IBM: 
Have the user source program, user macro 
definitions and associated listing 
available. 

e If the COPY statement was used, execute 
the IEBPTPCH utility program to obtain a 
copy of the PDS member specified in the 
COPY statement. 


SET SYMBOL USAGE INCONSISTENT WITH 
DECLARATION 


Explanation: A SET symbol has been 
declared as undimensioned, but is 
subscripted, or has been declared 


.dimensioned, but is unsubscripted. 


Severity Code: 8 


Programmer Response: Make sure the source 
code is correct and reassemble if 
necessary. If the problem recurs, do the 
following before calljng IBM: 


‘e Have the user source program, user macro 


definitions and associated listing 
available. 

e If the COPY statement was used, execute 
the LEBPTPCH utility program to oktain a 
copy of the PDS member specified in the 
COPY statement. 


ILLEGAL SYMBOLIC PARAMETER 
An attribute has been 


requested for a variable symbol which is 
not a legal symbolic parameter. 





Severity Code: 8 


Programmer Response: Make sure the source 


‘code is correct and reassemble if 


necessary. If the problem recurs, do the 


‘following before calling IBM: 
e Have the user source program, user macro 


definitions and associated listing 
available. 

e If the COPY statement was used, execute 
the IEBPTPCH utility program to obtain a 
copy of the PDS member specified in the 
COPY statement. 


AT LEAST ONE RELOCATABLE Y TYPE CONSTANT IN 
ASSEMBLY 


Explanation: One or more relocatakle 
Y-type constants in assemkly; relocation 
may result in address greater than 2 bytes 
in length. 

Severity Code: 4 

Programmer Response: Make sure the source 
code is correct and reassemble if 


Appendix A. Diagnostic Messages 43 


Page of GC26-3756-6 
Revised July 15, 1972 
By TNL GN33-8144 


IEU047 


LEU048 


IEUO4S 


IEU050 


44 


necessary. 


If the problem recurs, do the 

following before calling IBM: 

e Have the user source program, user macro 
definitions and associated listing 
available. 

e If the COPY statement was used, execute 
’ the IEBPTPCH utility program to obtain a 
copy of the PDS member specified in the 

COPY statement. 


SEQUENCE SYMBOL PREVIOUSLY DEFINED 


Severity Code: 12 


Programmer Response: Make sure the source 
code is correct and reassemble if 
necessary. If the problem recurs, do the 
colt ng before calling IBM: 
Have the user source program, user macro 
definitions and associated listing 
available. 

e If the COPY statement was used, execute 
the IEBPTPCH utility program tc obtain a 
copy Of the PDS member specified in the 
COPY statement. 


SYMBOLIC PARAMETER PREVIOUSLY DEFINED OR 
SYSTEM VARIABLE SYMBOL DECLARED AS SYMBOLIC 
PARAMETER 


Severity Code: 12 


Programmer Response: Make sure the source 
code is correct and reassemble if 
necessary. If the problem recurs, 
canal before calling 1BM: 
Have the user source program, user macro 
definitions and associated listing 
available. 

e If the COPY statement was used, execute 
the IEBPTPCH utility program tc obtain a 
copy of the PDS member specified in the 
COPY statement. 


do the 


VARIABLE SYMBOL MATCHES A PARAMETER 


as 19 
Ve ‘ 


Programmer Response: Make sure the source 
code is correct and reassemble if 
necessary. If the problem recurs, 
font owed before calling IBM: 
Have the user source program, user macro 
definitions and associated listing 
available. 

e If the COPY statement was used, execute 
the IEBPTPCH utility program tc obtain a 
copy of the PDS member specified in the 
COPY statement. 


do the 


INCONSISTENT GLOBAL DECLARATIONS 


Explanation: A global ‘SET variable symbol, 
defined in more than one macro definition 
or defined in a macro definition and in the 
source program, is inconsistent in SET type 
or dimension. 


Severity Code: 8 


Programmer Response: Make sure the source 
code is correct and reassemble if 
necessary. If the problem recurs, do the 
following before calling IBM: 

e Have the user source program, user macro 


IEU051 
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definitions and associated listing 
available. 

e If the COPY statement was used, execute 
the IEBPTPCH utility program to obtain a 
copy of the PDS member specified in the 
COPY statement. 


MACRO DEFINITION PREVIOUSLY DEFINED 


Explanation: Prototype operation field is 
the same aS a machine or assembler 
instruction or a previous prototype. This 
message is not produced when a programmer 
macro matches a system macro. The 
programmer macro will be assembled with no 
indication of the corresponding system 
macro. 


Severity Code: 12 


Programmer Response: Make sure the source 
code is correct and reassemble if 
necessary. If the problem recurs, do the 
following before calling IBM: 

e Have the user source program, user macro 
definitions and associated listing 
available. 

e If the COPY statement was used, execute 
the IEBPTPCH utility program to obtain a 
copy of the PDS member specified in the 
COPY statement. 


NAME FIELD CONTAINS ILLEGAL SET SYMBOL 


Explanation: SEI symbol in name field does 
not correspond to SET statement type. 


Severity Code: 8 


Programmer Response: Prokakle user error. 

Make sure the source code is correct and 

reassemble if necessary. If the problem 

recurs, do the following before calling 

IBM: 

e Have the user source program, user macro. 
definitions, and and associated listings 
available. 

e If the COPY statement was used, execute 
the IEBPTPCH utility program to obtain a 
copy of the PDS member specified in the 
COPY statement. 


GLOBAL DICTIONARY FULL 


Explanation: The global dictionary is 
full, assembly terminated. 


Severity Code: 12 


Programmer Response: Probable user error. 
Take one or more of the following steps and 
then rerun the job: 

e Split the assembly into two or more parts 
and assemble each separately. 

* Allocate more core for the assembler (the 
global and local dictionaries together 
can occupy up to 64K). 

e Run the assembly under Assembler E, 
unless it includes features not allowed 
by Assembler E. (fue to its dictionary 
building algorithm, Assembler E can 
handle more symbols with a given size 
dictionary than can Assembler F.) 

e Specify a smaller SYSLIB blocksize. 


ILEU054 
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Thus, if BLKSIZE=1800 or BLKSIZE=1200, 
reblock the library to the size chosen, 
and try the assembly again. 

If the problem recurs, do the following 

before calling IBM for programming support: 

e Have the user source program, user macro 
definitions, and associated listings 
available. 

e If the COPY statement was used, execute 
the IEBPTPCH utility program tc cbtain a 
copy of the PDS member specified in the 
COPY statement. 


LOCAL DICTIONARY FULL 


Explanation: The local dictionary is full, 
current macro aborted and the macro 
instruction is flagged as undefined. 
cpen code, assembly terminated. 


1f in 


Severity Code: 12 


Programmer Response: Probable user error. 
Take one or more of the following steps and 
then rerun the joks. 

e Split the assembly into two or more parts 
and assemble each separately. 

e Allocate more core for the assembler (the 
global and local dictionaries tcgether 
can cccupy up to 64k). 

e Run the assembly under Assembler E, 
unless it includes features not allowed 
by Assembler E, (Due to its dictionary 
building algorithm, Assembler E can 
handle more symbols with a given size 
dictionary than can Assembler F.) 

e Specify a smaller SYSLIB blocksize. 

Thus, if BLKSIZE=1800 or BLKSIZE=1200, 
reblock the library to the size chosen, 
and try the assemkly again. 

e Specify smaller SYSUT1 blocksize. 

If the problem recurs, do the following 

before calling IBM for programming support: 

e Have the user source program, user macro 
definitions, and associated listings 
available. 

e If the COPY statement was used, execute 
the IEBPTPCH utility program tc cbtain a 
copy of the PDS member specified in the 
COPY statement. 


INVALIC ASSEMBLER OPTION(S) ON THE EXECUTE 
CARL 


Severity Code: 8 


Programmer Response: Probable user error. 

Make sure all assembler options specified 

are correct and reassemble if necessary. 

If problem recurs, do the following before 

calling IBM: 

e Make sure that MSGLEVEL=(1,1) was 
specified in the JOB statement. 

* Have the user source program, user macro 
definitions, and associated listings 
available. 


ARITHMETIC OVERFLOW 
Explanation: The intermediate or final 


result of an expression is not within the 
range of -231 to 231-1, 
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Severity Code: 8 


Programmer Response: Prokakle user error. 
Make sure the source code is correct and 
reassemble if necessary. If the problem 
recurs, do the following kefore calling 
IBM : 

e Have the user source program, user macro 
definitions, and associated listings © 
available. 

e If the COPY statement was used, execute 
the IEBPTFCH utility program to oktain a 
copy of the PDS member specified in the 
CCFY statement. 


SUBSCRIFT.NCT WITHIN CIMENSIONS 


Explanation: (1) Supscrift of &SYSLIST or 
symbolic parameter exceeds 200 or is 
negative. (2) Subscript of symkolic 
parameter is zero. (3) Subscript of SET 
symbol exceeds dimension specified in 
GBLx/LCLx statement. 


Severity Code: 8 


Programmer Response: Make sure the source 
code is correct and reassemkle if 
necessary. If the problem recurs, do the 
following before calling IEM: 

e Have the user source prcgram, user macro 
definitions and associated listing 
available. 

e If the COPY statement was used, execute 
the IEBPTECH utility program to oktain a 
copy of the PDS mwember specified in the 
CCFY statement. 


RE-ENTRANT CHECK FAILED 
Explanation: An instruction has been 
detected, which, when executed, might store 
data into a control section or a common 
area. This message is generated only when 
requested via control cards and merely 
indicates a possible re-entrant error. 
statement number is not given in the 
message. 


The 


Severity Code: 4 


mer Response Make sure the source 
code is correct and reassemble if 
necessary. If the problem recurs, do the 
following before calling IEM: 

e Have the user source prcgram, user macro 
definitions and associated listing 
available. 

e If the CCFY statement was used, execute 
the IEBPTPCH utility prcegram to obtain a 
copy of the PLS member specified in the 
COPY statement. 


UNDEFINED SECUENCE SYMBOL 


Severity Code: 12 

Programmer Response: Make sure the source 
code is correct and reassemkle if 
necessary. If the problem recurs, do the 
following before calling IBY: 

e Have the user source program, user macro 
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definitions and associated listing 
available. 

e If the COPY statement was used, execute 
the IEBPTPCH utility program to obtain a 
copy of the PDS member specified in the 
COPY statement. 


ILLEGAL ATTRIBUTE NOTATION 


Explanation: L‘', S*, or I' 
parameter whose type attribute dces not 
allow these attributes to be requested. 


Severity Code: 8 


Programmer Response: Make sure the source 
code is correct and reassemble if 
necessary. If the problem recurs, do the 
Fol rowan before calling IBM: 
Have the user source program, user macro 
definitions and associated listing 
available. 

e If the COPY statement was used, execute 
the LEBPTPCH utility program to obtain a 
copy of the PLS member specified in the 
COPY statement. 


ACTR COUNTER EXCEEDED 
Explanation: Conditional assembly loop 


counter exceeded; conditional assembly 
terminated. 


Severity Code: 12 


Programmer Response: Make sure the source 
code is correct and reassemble if 
necessary. If the problem recurs, 
following before calling IBM: 

e Have the user source program, user macro 
definitions and associated listing 
available. 

e If the COPY statement was used, execute 
the IFBPTPCH utility prograr tc obtain a 
copy of the PDS member specified in the 
COPY statement. 


dc the 


GENERATED STRING GREATER THAN 255 
CHARACTERS 


Severity Code: 8 


Programmer Response: Make sure the source 
code is correct and reassemble if 
necessary. If the problem recurs, do the 
following before calling IBM: 

e Have the user source program, user macro 
definitions and associated listing 
available. 

e If the COPY statement was used, execute 
the IEBPTPCH utility program tc cbtain a 
cory of the PDS member specified in the 
COPY statement. 


EXPRESSION 1 OF SUBSTRING IS ZERO OR MINUS 


Severity Code: 8 


Programmer Response: Make sure the source 
code is correct and reassemble if 
necessary. If the problem recurs, 
following before calling IBM: 
e Have the user source program, user macro 
definitions and associated listing 


dc the 


requested fora 
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available. 

e If the CCFY statement was used, execute 
the IEEBPTFCH utility program to oktain a 
copy of the PDS member specified in the 
CCFY statement. 


EXPRESSICN 2 CF SUESTRING IS ZERO OR MINUS 


Severity Code: 8 


Frogrammer Response: Make sure the source 
code is correct and reassemble if 
necessary. If the problem recurs, do the 
following before calling IEM: 

e Have the user source prcgram, user macro 
definitions and associated listing 
available. 

e If the CCFY statement was used, execute 
the IEBPTPCH utility prcgram to obtain a 
copy of the PLS member specified in the 
CCFY statement. 


INVALID OR ILLEGAL TERM IN ARITHMETIC 
EXFRESSICN 


Explanation: The value of a SETC symkcl 
used in the arithmetic expression is not 
composed of decimal digits, or the 
parameter is not a self-defining term. 


Severity Code: 8 


mer Res Make sure the source 
code is correct en reassemble if 
necessary. If the proklem recurs, 
pig emia) before calling IEM: 
Have the user source prcgram, user macro 
definitions and associated listing 
available. 

e If the COPY statement was used, execute 
the IERPTECH utility program to oktain a 
copy of the PDS member specified in the 
CCFY statement. 


do the 


UNDEFINED CR CUPLICATE KEYWORE OPERAND 


Explanation: The same keyword operand 
occurs more than once in the macro 
instruction; a keyword is not defined in a 
prototype statement. 


Severity Code: 12 

Programmer Response: Make sure the source 

code is correct and reassemkle if 

necessary. If the problem recurs, do the 
following before calling IBM: 

e Have the user source prcgram, user macro 
definitions and associated listing 
available. 

e If the COPY statement was used, execute 
the IEBPTFCH utility program to oktain a 
copy of the FDS member specified in the 
COPY statement. 


EXPRESSION 1 OF SUBSTRING GREATER THAN 
LENGTH CF CHARACTER EXPRESSION 


Severity Code: 8 


rammer Res Probable user error. 
Make sure the Eaipes code is correct and 
reassemble if necessary. If the prokler 
recurs, do the following before calling 


LEU0 68 
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IBM: 

e Have the user source program, user macro 
definitions, and associated listings 
available. 

e If the COPY statement was used, execute 
the IEBPTPCH utility program tc cbtain a 
copy of the PDS memker specified in the 
COPY statement. 


GENERATION TIME DICTIONARY AREA CVERFLOWED 


Severity Code: 12 


Programmer Response: Probable user error. 
Take one or more of the following steps and 


then rerun the job: 

e Split the assembly into two or mere farts 
and assemble each separately. 

e Allocate more core the assembler (the 
global and local dictionaries together 
can occupy up to 64K). 

e Run the assembly under Assembler E, 
unless it includes features not allowed 
by Assembler E. (Due to its dicticnary 
building algotithm, Assembler F can 
handle more symbols with a given size 
dictionary then can Assembler F.) 

e Specify a smaller SYSLIB blocksize. 
Thus, if BLKSIZE=1800 or BLKSIZE=1200, 
reblock the library to the size chosen, 
and try the assembly again. 

e Specify smaller SYSUT1 blocksi ze. 

If the problem recurs, do the follcwing 

before calling IBM for programming support: 

e Have the user source program, user macro 
definitions, and associated listings 
available. 

°* If the COPY statement was used, execute 
the IEFEPTPCH utility program tc cbtain a 
copy of the PDS member specified in the 
COPY statement. 


VALUE OF EXPRESSION 2 OF SUBSTRING GREATER 
THAN 8 


Severity Code: 8 


Programmer Response: Probable user error. 

Make sure the source code is correct and 

reassemble if necessary. If the prcblem 

recurs, do the following before calling 

IPM: 

e Have the user source program, user macro 
definitions, and associated listings 
available. 

e If the COPY statement was used, execute 
the IEBPTPCH utility program tc obtain a 
copy of the PDS member specified in the 
COPY statement. 


FLOATING POINT CHARACTERISTIC OUT OF RANGE 


Explanation: Exponent too large for length 
of defining field, exponent modifier has 
caused loss of all significant digits. 


Severity Code: 12 


Programmer Response: Make sure the source 

code is correct and reassemble if 

necessary. If the problem recurs, 

following before calling IBM: 

e Have the user source progran, user macro 
definitions and associated listing 


dec the 


1EU071 
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available. 

e If the COPY statement was used, execute 
the IEBPTPCH utility program to oktaina 
copy of the PDS member specified in the 
CCFY statement. 


ILLEGAL CCCURRENCE OF LCL, GEL, OR ACTR 
STATEMENT 


nation LCL, GBL, or ACTR statement 
not in proper place in the program. 


Severity Code: 8 


Froqrammer Response: Make sure the source 
code is correct and reassemble if 
necessary. If the problem recurs, do the 
following before calling IEM: 

e Have the user source prcgram, user macro 
definitions and associated listing 
available. 

e If the CCFY statement was used, execute 
the IEBPTECH utility program to oktain a 
copy of the PDS wember specified in the 
CCFY statement. 


ILLEGAL RANGE ON ISEO STATEMENT 


Explanation: One or more columns to Le 
sequence checked are between the "kegin" 
and “end" columns cf the statement. 


Severity Code: 4 


Programmer Response: Make sure the source 
code is correct and reassemble if 
necessary. If the problem recurs, 
following before calling IBM: 

¢ Have the user source prcgram, user macrce 
definitions and associated listing 
available. 

e If the COPY statement was used, execute 
the IEBPTECH utility program to oktain a 
copy of the PDS member specified in the 
CCPY statement. 


do the 


ILLEGAL NAVE FIELD 


nation (1) The name field is blank 
in a statement where a name is required. 
(2) A name is present where no name is 
allowed. (3) The wrong type of symbol is 
in the name field (e.g., an ordinary symbol 
in a conditional assembly statement). 


Severity Code: 8 


Programmer Response: Make sure the source 
code is correct and reassemkle if 


necessary. If the problem recurs, do the 

following before calling IEM: 

e Have the user source prcgram, user macro 
definitions and associated listing 
available. 

e If the COPY statement was used, execute 
the IEBPTPCH utility program to obtain a 
copy of the FLS member specified in the 
COPY statement. 


ILLEGAL STATEMENT IN COPY COLE OR SYSTEM 


MACRC 


A statement keing copied was 
ICTL, ISEG, MACRO, MENT, 


Explanation: 
a CCFY, ENL, 
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OPSYN, or a model statement in a macro 
containing an END, PRINT, COPY, ISEQ, 
OPSYN. 


ICTL, 


Severity Code: 8 


Programmer Response: Make sure the source 


‘ code is correct and reassemble if 
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necessary. If the problem recurs, do the 

following before calling IBM: 

e Have the user source program, user macro 
definitions and associated listing 
available. 

e If the COPY statement was used, execute 
the IEBPTPCH utility program to obtain a 
copy of the PDS member specified in the 
COPY statement. 


ILLEGAL STATEMENT OUTSIDE OF A ERERS 
DEFINITION ; 


Explanation: ‘Statement allowed only in a 
macre definition encountered outside macro 
definitions (in open code), e.g., period 


_asterisk (-*) , MNOTE statement. 


Severity Code: 8 


Programmer Response: Make sure the source 

code is correct and reassemble if 

necessary. If the problem recurs, 
following before calling IBM: 

e Have the user source program, user macro 
definitions and associated listing 
available. 

° If the COPY statement was used, execute 
the IEBPTPCH utility program to obtain a 
copy of the PDS member specified in the 
COPY statement. 


do the 


SEQUENCE ERROR 
Explanation: Sequence error discovered by 


the sequence checking mechanism initiated 
by an ISEQ instruction. 


Severity Code: i2 
Programmer Response: 


Make sure the source 


‘code is correct and reassemble if 


necessary. If the problem recurs, do the 

Hoh vOWAnG before calling IBM: 

Have the user source program, user macro 
definitions and associated: listing 
available. 

e If the COPY statement was used, execute 
the IEBPTPCH utility program to. obtain a 
copy of the PDS member specified in the 
COPY statement. 


ILLEGAL CONTINUATION CARD 


Explanation: Either there are too many 
continuation cards, or there are non-blanks 
between the begin and continue columns on 
the continuation card. 


Severity Code: 8 


Programmer Response: Probable user error. 

Make sure source is correct and reassemble 

if necessary. If the problem recurs, do 

the following before calling IBM: 

e Have the user source program, user macro 
definitions, and associated listings 


IEU078 


IEU079 


IEU080 


available. an 

e If the COPY statement was used, execute 
the IEBPTPCH utility program to obtain a 
copy of the PDS member specified in the 
COPY statement. 


INCOMPATIBLE ASSEMBLER OPTIONS oN THE 
EXECUTE CARD 


Explanation: One of the following: 
The DOS assembler option has been 
specified along with: LOAD, TEST, RENT, 
TERM, Or NOALGN. The assembler has used 
the options specified. 

e The NUM or STMT option has been specified 
along with NOTERM. The assembler has not 
produced any SYSTERM output. 


Severity Code: 0 


Programmer Response: Make sure all 
assembler options specified are correct and 


reassemble if necessary. If problem 

recurs, do the following before calling 

IBM: 

e Make sure that MSGLEVEL= (1,1) was 
specified in the JOB statement. 

e Have the user source program, user macro 
definitions, and associated listings 
available. 


ILLEGAL STATEMENT IN MACRO DEFINITION 


Explanation: This operation is not allowed 
within a macro definition. 


Severity Code: 8 


Programmer Response: Probable user error. 

Make sure the source code is correct and 

reassemble if necessary. If the problem 

recurs, do the following before calling 

IBM: 

e Have the user source program, user macro 
definitions, and associated listings 
available. 

e If the COPY statement was used, execute 
the IEBPTPCH utility program to obtain a 
copy of the PDS member specified in the 
COPY statement. 


ILLEGAL START CARD 


Explanation: Statements affecting or 
depending upon the location counter have 
been encountered before a START statement. 


Severity Code: 8 


Programmer Response: Make sure the source 
code is correct and reassemble if 
necessary. If the problem recurs, do the 
following before calling IBM: 

e Have the user source program, user macro 
definitions and associated listing 
available. 

e If the COPY statement was used, execute 
the IEBPTPCH utility program to oktain a 
copy of the PDS member specified in the 
COPY statement. 


IEU081 


LEU08 2 


IEU083 


IEUO84 


ILLEGAL FORMAT IN GBL OR LCL STATEMENTS 


Explanation: An operand is not a variable 


symbol. 


Severity Code: 8 


Programmer Response: Make sure the source 

code is correct and reassemble if 

necessary. If the problem recurs, 
following before calling IBM: 

e Have the user source program, user macro 
definitions and associated listing 
available. 

e If the COPY statement was used, execute 
the IEBPTPCH utility program tc obtain a 
copy of the PDS member specified in the 
COPY statement. 


dc the 


ILLEGAL DIMENSION SPECIFICATION IN GBL OR 
LCL STATEMENT 


Explanation: Dimension is other than 1 to 


2500. 


Severity Code: 8 


Programmer Response: Make sure the source 
code is correct and reassemble if 
necessary. If the problem. recurs, do the 
following before calling IBM: 

e Have the user source program, user macro 
definitions and associated listing 
available. 

e If the COPY statement was used, execute 
the IEBPTPCH utility program tc cbtain a 
copy of the PDS member specified in the 
COPY statement. 


SET STATEMENT NAME FIELD NOT A VARIAELE 
SYMBOL 


Severity Code: 8 


Programmer Response: Make sure the source 
code is correct and reassemble if 
necessary. If the problem recurs, do the 
following before calling IBM: 

e Have the user source program, user macro 
definitions and associated listing 
available. 

e If the COPY statement was used, execute 
the IEBPTPCH utility program tc cbtain a 
copy of the PDS member specified in the 
COPY statement. 


ILLEGAL OPERAND FIELD FORMAT 


Explanation: Syntax invalid, e.g., AIF 
statement operand does not start with a 
left parenthesis; operand of AGO is nota 
sequence symbol; operand of PUNCH, TITLE, 
MNOTE not enclosed in quotes. 


Severity Code: 8 
Programmer Response: Make sure the source 


code is correct and reassemble if 

necessary. If the problem recurs, 

following before calling IBM: 

e Have the user source program, user macro 
definitions and associated listing 
available. 

e If the COPY statement was used, execute 
the IEBPTPCH utility program tc cbtain a 


dc the 


IEU085 


IEU086 


IEU087 


copy of the FLS member specified in the 
COPY statement. 


INVALID SYNTAX IN EXPRESSION 


nation Invalid delimiter, too many 
Paeae in expression, tco many levels of 
parentheses, two operators in succession, 
two terms in succession, or illegal 
character. 


Severity Code: 8 


Programmer Response: Make sure the source 
code is correct and reassemble if 


necessary. If the problem recurs, do the 

following before calling IEM: 

e Have the user source prcgram, user macro 
definitions and associated ed 
available. 

e If the COPY statement was “used, ‘execute 
the IEBPTFCH utility program to oktain a 
copy of the PDS member specified in the 
COPY statement. 


ILLEGAL USAGE OF SYSTEM VARIABLE SYMBOL 


Explanation: A system variable symkol 
appears in the name field of a SET 
statement, is declared in a GBL or ICL 
statement, or is an unsukscripted &SYSLIST 
in a context other than N‘&SYSLIST. 


Severity Code: 8 


Programmer Response: © Make sure the source 
code is correct and reassemble if 


necessary. If the problem recurs, .do the 

EOP OWING before calling IEM: 

Have the user source program, user macro 
definitions and associated listing 
available. , 

e If the COPY statement.was used, execute 
the IEEBPTPCH utility program to obtain a 
copy of the PFS member specified in the 
COPY statement. 


NO ENDING APOSTROPHE 


Explanation: There is an unpaired 
apostrophe or ampersand in the statement. 


Severity Code: 8 


Programmer Response: Make sure the source 

code is correct and reassemble if | 

necessary. If the problem recurs, 
following before calling IEM: 

e Have the user source prcgram, user macro 
definitions and associated listing 
available. 

e If the COPY statement was used, execute 
the IEEPTFCH utility program to oktain a 
copy of the PDS member specified in the 
CCFY statement. 


do the 
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IEFU088 


LEU089 


IEU090 
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UNDEFINED OPERATION CODE 


Explanation: Symkol in operation ccde 
field does not correspond to a valid 
machine or assembler operation code or to 
any operation code in a macro prctctyre 
statement, or a SYSLIB date set has not 
been provided. If the statement is OPSYN, 
the operand entry is not a defined machine 
or extended operation code, or the operand 
entry is omitted and the name entry is not 
a defined machine or extended operation 
code. If the DOS option is in effect, DXD 
and CXC operation codes will be flagged as 
undefined. 


Severity Code: 12 


Programmer Response: Probable user error. 
Make sure the source code is correct and 
reassemble if necessary. If problem 
recurs, do the following before calling 
IBM: 

e Make sure that MSGLEVEL=(1,1) was 
specified in the JOB statement. 

e Have the user source program, user macro 
definitions, and associated listings 
available. 

e If the COPY statement was used, execute 
the IEBPTPCH utility program to obtain a 
copy of the PDS member specified in the 
COPY STATEMENT. 


INVALIC ATTRIBUTE NOTATION 


Explanation: Syntax error inside a macro 
definition, e.g., the argument of the 
attribute reference is not a symbclic 
parameter. 


Severity Code: 8 


Programmer Response: Probable user error. 


Make sure the source code is correct and 
reassemble if necessary. If the percblem 
recurs, do the following before calling 
IEM. 

e Have the user source program, user macro 
definitions, and associated listings 
available. 

e If the COPY statement was used, execute 
the IEBPTPCH utility program to obtain a 
copy of the PDS member specified in the 
COPY statement. 


INVALID SUBSCRIPT 


Explanation: Syntax error, e.g., dcuble 
subscript where single subscript is 
required or vice versa; not right 
parenthesis after subscript. 


Severity Code: 8 


Rrogrammer Response: Make sure the source 
code is correct and reassemble if 
necessary. If the problem recurs, do the 
following before calling IBM: 

e Have the user source program, user macro 
definitions and associated listing 
available. 

e If the COPY statement was used, execute 
the IEBPTPCH utility program tc obtain a 
copy of the PDS member specified in the 
COPY statement. 


IEU091 INVALID SELF-DEFINING TERM 


IEU092 


LEU093 


IEUO094 


nation Value is tcc large or is 
inconsistent with the data type, i.e., 
severity code of MNOTE statement greater 
than 255. 


Severity Code: 8 


Programmer Response: Make sure the source 
code is correct and reassemble if 
necessary. If the proklem recurs, do the 
following before calling IEM: 

e Have the user source prcgram, user macro 
definitions and associated listing 
available. 

e If the COPY statement was used, execute 
the ILEBPTFCH utility program to oktain a 
copy of the FILS member specified in the 
COPY statement. 


INVALID FORMAT FOR VARIABLE SYMBOL 


Explanation: The first character after the 
ampersand is not alphabetic, or the 
variakle symbol contains more than 8 
characters, or failure to use double 
ampersand in TITLE card or character 
self-defining term. 


Severity Code: 8 


Programmer Response: Make sure the source 
code is correct and reassemble if 
necessary. If the problem recurs, do the 
following before calling IBM: 

e Have the user source prcgram, user macro 
definitions and associated listing 
available. 

e If the COPY statement was used, execute 
the LEBPTFCH utility program to oktain a 
copy of the FILS member specified in the 
COPY statement. 


UNBALANCED FARENTHESIS OR EXCESSIVE LEFT 
PARENTHESES 


Explanation: End cf statement or card 
encountered before all parenthesis levels 
are satisfied. May be caused by embedded 
blank or other unexpected terminator, or 
failure to have a punch in continuation 
column. 


Severity Code: 8 


Programmer Response: Make sure the source 
code is correct and reassemble if 
necessary. If the problem recurs, do the 
following before calling IEM: 

e Have the user source prcgram, user macro 
definitions and associated listing 
available. 

e If the COPY statement was used, execute 
the IEBPTFCH utility program to oktain a 
copy of the PLS member specified in the 
COPY statement. 


INVALID OR ILLEGAL NAME OR OPERATION IN 
PROTOTYPE STATEMENT 


nation Name not blank or variable 
symkol, or variable symbol in name field is 
subscripted, or violation of rules for 
forming variable symbol (must Legin with 


IEU095 


IEU096 


LEU097 


ampersand (&) followed by 1-7 letters 
and/or numbers first of which must be a 
letter), or statement following 'MACRO' is 
not a valid prototype statement. 


Severity Code: 12 


Programmer Response: Make sure the source 
code is correct and reassemble if 
necessary. If the problem recurs, do the 
following before calling IBM: 

e Have the user source program, .user macro 
definitions and associated listing 
available. 

e If the COPY statement was used, execute 
the IEBPTPCH utility program tc obtain a 
copy of the PDS member specified in the 
COPY statement. 


ENTRY TABLE OVERFLOW 


Explanation: Number of ENTRY symbols, 
i.e., ENTRY instruction operands, exceeds 
100. 


Severity Code: 8 


Programmer Response: Make sure the source 
code is correct and reassemble if 
necessary. If the problem recurs, do the 
following before calling IBM: 

¢ Have the user source program, user macro 
definitions and associated listing 
available. 

e If the COPY statement wasS used, execute 
the IEBPTPCH utility program tc obtain a 
copy of the PDS member specified in the 
COPY statement. 


MACRO INSTRUCTION OR PROTOTYPE OPERAND 
EXCEEDS 255 CHARACTERS IN LENGTH 


Severity Code: 12 


Programmer Response: Make sure the source 
code is correct and reassemble if 
necessary. If the problem recurs, dc the 
following before calling IBM: 

e Have the user source program, user macro 
definitions and associated listing 
available. 

e If the COPY statement was used, execute 
the IEBPTPCH utility program tc obtain a 
copy of the PDS member specified in the 
COPY statement. 


INVALID FORMAT IN MACRO INSTRUCTION OPERAND 
OR PROTOTYPE PARAMETER 


Explanation: This message can be caused 


by: 


1. Illegal "=". 

2. A single "&" appears somewhere in the 
standard value assigned to a prototype 
keyword parameter. 

3. First character of a prototype parameter 
is not "&", 

4. Prototype parameter is a subscripted 
variable symbol. 


LEU098 


IEU099 


IEU100 
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5. Invalid use of alternate format in 
prototype statement, e.g., 
10 16 


72 
PROTO 6A, 6B, 
or 
PROTO &A,6B, X 
&C 


6. Unintelligible prototype parameter, 
e.g., “&A*" or “S&A&E." 

7. Illegal (non-assembler) character 
appears in prototype parameter or macro 
instruction operand. 


Severity Code: 12 


Programmer Response: Make sure the source 
code is correct and reassemble if 
necessary. If the problem recurs, do the 
following before calling IBM: 

e Have the user source program, user macro 
definitions and associated listing 
available. 

e If the COPY statement was used, execute 
the IEBPTPCH utility program to obtain a 
copy of the PDS member specified in the 
COPY statement. 


EXCESSIVE NUMBER OF OPERANDS OR PARAMETERS 
Either the prototype has more 


or the macro 
than 200 operands. 


Explanation: 
than 200 parameters, 


instruction has more 





Severity Code: 12 


Programmer Response: Make sure the source 
code is correct and reassemble if 
necessary. if the problem recurs, 
following before calling IBM: 

e Have the user source program, user macro 
definitions and associated listing 
available. 

e If the COPY statement was used, execute 
the IEBPTPCH utility program to obtain a 
copy of the PDS member specified in the 
COPY statement. 


do the 


POSITIONAL MACRO INSTRUCTION OPERANC, 
PROTOTYPE PARAMETER OR EXTRA COMMA FOLLOWS 
KEYWORD 


Severity Code: 12 


Programmer Response: Make sure the source 
code is correct and reassemble if 
necessary. I1f the problem recurs, do the 
spEtownd before calling IBM: 
Have the user source program, user macro 
definitions and associated listing 
available. 

e If the COPY statement was used, execute 
the IEBPTPCH utility program to obtain a 
copy of the PDS member specified in the 
COPY statement. 


STATEMENT COMPLEXITY EXCEEDED 
Explanation: More than 32 operands ina 


DC, DS, DXD, or literal DC, or more than 50 
terms ina statement. 


Severity Code: 8 
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IEU101 


LEU 102 


IEU 103 
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Programmer Response: Make sure the source 
code is correct and reassemble if 
necessary. If the problem recurs, do the 
col lowsrag before calling IBM: 
Have the user source program, user macro 
definitions and associated Listing 
available. 

e If the COPY statement was used, execute 
the IEBPTPCH utility program to obtain a 
copy of the PDS member specified in the 
COPY statement. 


EOD ON SYSIN 


Explanation: EOD before END card. 


Severity Code: 12 


Programmer Response: Make sure the source 
code is correct and reassemble if 
necessary. If the problem recurs, do the 
following before calling IBM: 

® Have the user source program, user macro 
definitions and associated listing 
available. 

° If the COPY statement was used, execute 
the IEBPTPCH utility program tc obtain a 
copy of the PDS member specified in the 
COPY statement. 


INVALID OR ILLEGAL ICTL 


Explanation: The operands of the ICIL are 
out of range, or the ICTL is not the first 
Statement in the input deck. (Assembly is 
terminated and further input is ignored.) 


Severity Code: 16 


Programmer Response: Make sure the source 
code is correct and reassemble if 
necesSary. If the problem recurs, do the 
following before calling IBM: 

e Have the user source program, user macro 
definitions and associated listing 
available. 

e If the COPY statement was used, execute 
the IEBPTPCH utility program tc obtain a 
copy of the PDS member specified in the 
COPY statement. 


ILLEGAL NAME IN OPERAND FIELD OF COPY CARD 


Explanation: Syntax error, e.g., symbol 
has more than 8 characters or has an 
illegal character. 


Severity Code: 12 


Programmer Response: Probable user error. 
Make sure the source code is correct and 
reassemble if necessary. If the problem 
recurs, do the following before calling 
IBM: 

e Have the user source program, user macro 
definitions, and associated listings 
available. 

e If the COPY statement was used, execute 
the IEBPTPCH utility program tc obtain a 
copy of the PDS member specified in the 
COPY statement. 


IEU104 


IEU105 


IEU106 


LEU 107 


COPY CODE NOT FOUNLT 


Explanation: The operand of a COPY 
statement specified COPY text which cannot 
be found in the library. 


Severity Code: 12 


Programmer Response: Probkable user error. 
Make sure the source code is correct and 
reassemble if necessary. If problem 
recurs, do the following tefore calling 
IBM: 

e Make sure 
included. 

e Make sure that MSGLEVEL=(1,1) was 
specified in the JOB statement. 

e Have the user source program, user macro 
definitions, and associated listings 
available. 

e If the COPY statement was used, execute 
the LEBPTPCH utility program to obtain a 
copy of the PDS member specified in the 
COPY statement. 


the SYSLIB [LD statement is 


EOD ON SYSTEM MACRO LIBRARY 


Explanation: EOD before MEND card. 


Severity Code: 12 


Programmer Response: Probable user error. 
Make sure the source code is correct and 
reassemble if necessary. If the problem 
recurs, do the following before calling 
IBM: 

e Have the user source program, user macro 
definitions, and associated listings 
available. 

e If the COPY statement was used, execute 
the IEBPTPCH utility program to obtain a 
copy of the PDS member specified in the 
COPY statement. 


NOT NAME OF PSECT OR DXD 


Referenced symbol expected to 
but it is not. 


Explanation: 
be DSECT name, 


Severity Code: 8 


Programmer Response: Make sure the source 
code iS correct and reassemble if 
necessary. If the problem recurs, 
Falta og before calling IBM: 
Have the user source program, user macro 
definitions and associated listing 
available. 

e If the COPY statement was used, execute 
the IEBPTPCH utility program to obtain a 
copy of the PPS member specified in the 
COPY statement. 


do the 


INVALID OPERAND 
Explanation: Invalid syntax in DC operand, 


e.g., invalid hexadecimal character in 
hexadecimal DC; operand string too long for 
X, B, C, DC's; operand unrecognizakle, 
contains invalid value, or incorrectly 
specified. 


1EU108 


IEU109 


LEU110 


Severity Code: 8 


Programmer Response: Probable user error. 
Make sure the source code is correct and 
reassemble if necessary. If the problem 
recurs, do the following before calling 
IBM: 

e Have the user source program, user macro 
definitions, and associated listings 
available. 

e If the COPY statement was used, execute 
the IEBPTPCH utility program to obtain a 
copy of the PDS member specified in the 
COPY statement. 


PREMATURE EOD 


Explanation: Indicates an internal 
assembler error; should not occur. 


Severity Code: 16 


Programmer Response: Reassemble; if the 

problem recurs, do the following before 

calling IBM: 

e Have the user source program, user macro 
definitions, and associated listings 
available. 

e If the COPY statement was used, execute 
the ILEBPTPCH utility program to obtain a 
copy of the PDS member specified in the 
COPY statement. 

e Make sure that MSGLEVEL=(1,1) was 
specified in the JOB statement. 


PRECISION LOST 


Severity Code: 8 


Programmer Response: Probable user error. 
Make sure the source code is correct and 
reassemble if necessary. If the prceblem 
recurs, do the following before calling 
IBM: 

e Have the user source program, uSer macro 
definitions, and associated listings 
available. 

e If the COPY statement was used, execute 
the IEBPTPCH utility program to obtain a 
copy of the PDS member specified in the 
COPY statement. 


EXPRESSION VALUE TOO LARGE 


Explanation: Value of expression not in 
range than -16777216 to +16777215. 
Expressions in EQU and ORG statements are 
flagged if (1) they include terms 
previously defined as negative values, or 
(2) positive terms give a result of more 
than three bytes in magnitude. The error 
indication may be erroneous due to (1) the 
treatment of negative values as three-byte 
positive values, or (2) the effect of large 
positive values on the location counter if 
a control section begins with a START 
statement having an operand greater than 
zero, or a control section is divided into 
subsections. 


Severity Code: 8 


IEU 111 


IEU112 


IEU 113 
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Programmer Response: Prokable user error. 

Make sure the source code is correct and 

reassemble if necessary. If the problem 

recurs, do the following kefore calling 

IBM: 

e Have the user source program, user macro 
definitions, and associated listings 
available. ; 

e If the COPY statement was used, execute 
the IEBPTPCH utility program to oktain a 
copy of the PDS member specified in the 
COPY statement. 


OPEN FAILED FOR SYSGO, NOLOAD OPTION USED 


Explanation: DD statement incorrect or 


missing. 
Severity Code: 16 


Programmer Response: Probable user error. 
If necessary supply missing DD statement or 
make sure that information on CC statement 
is correct and reassemble. If proklem 
recurs, do the following before calling 
IBM: 

e Have the user source program, user macro 
definitions, and associated listings 
available. 

e If the COPY statement was used, execute 
the ILEBPTPCH utility program to oktain a 
copy of the PDS member specified in the 
COPY statement. 

e Make sure that MSGLEVEL=(1,1) was 
specified in the JOB statement. 


OPEN FAILED FOR SYSPUNCH, 
USED 


NODECK OPTION 


Explanation: [CL statement incorrect or 


missing. 
Severity Code: 16 


Programmer Response: Probable user error. 
If necessary supply missing DL statement or 
make sure that information on DD statement 
is correct and reassemble. If proklem 
recurs, do the following before calling 
IBM: 

e Have the user source program, user macro 
definitions, and associated listings 
available. 

e If the COPY statement was used, execute 
the IEBPTPCH utility program to oktain a 
copy of the PDS member specified in the 
COPY statement. 

e Make sure that MSGLEVEL=(1,1) was 
specified in the JOB statement. 


OPEN FAILED FOR SYSTERM, NOTERM OPTION USED 


Explanation: DD statement incorrect or 


missing. 


Severity Code: 0 


Programmer Response: Prokakle user error. 
If necessary supply missing DL statement or 
make sure that information on DD statement 
is correct and reassemble. If problem 
recurs, do the following kLefore calling 
IBM: 
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1EU116 


IEU117 


e Have the user source program, user macro 
definitions, and associated listings 
available. 

e If the COPY statement was used, execute 
the IEBPTPCH utility program to obtain a 
copy of the PDS member specified in the 
COPY statement. 

e Make sure that MSGLEVEL= (1,1) was 
specified in the JOB statement. 


ILLEGAL OPSYN 


Explanation: An OPSYN statement may be 
preceded only by an ICTL instruction or 
another OPSYN statement. 


Severity Code: 8 


Programmer Response: Probable user error. 
Make sure the source code is correct and 
reassemble if necessary. If the problem 
recurs, do the following before calling 
IBM: 

e Have the user source program, user macro 
definitions, and associated listings 
available. 

e If the COPY statement was used, execute 
the IEBPTPCH utility program to obtain a 
copy of the PDS member specified in the 
COPY statement. 


OPSYN TABLE OVERFLOW 


Explanation: No room exists in symbol 
table for this and following OPSYN 
definitions; generated operation codes may 
not be processed correctly. 


Severity Code: 8 


Programmer Response: Probable user error. 
Make sure the source code is correct and 
reassemble if necessary. If the problem 
recurs, do the following before calling 
IBM: 

e Have the user source program, user macro 
definitions, and associated listings 
available. 

e If the COPY statement was used, execute 
the IEBPTPCH utility program tc obtain a 
copy of the PDS member specified in the 
COPY statement. 


IEU996I ASSEMBLY TERMINATED INSUFFICIENT STORAGE 


Explanation: One of the following: 


e The partition or region size is less than 


the mimimum required by the assembler. 

e The blocksize specified for the utility 
data sets is too large for available main 
storage. . 


System Action: Assembly is terminated. 


Severity Code: 20 


IEU997I OPEN FAILED FOR SYSPRINT, NOLISTI OPTION 
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USED 


Explanation: DD statement incorrect or 
missing. 


System Action: Processing continues. 


Severity Code: 0 


Programmer Response: Probable user error. 
If necessary supply the missing DD 
statement or make sure that information on 
the DD statement is correct; reassemble. 

If problem recurs, do the following before 

calling IBM: 

e Have the user source program, user macro 
definitions, and associated listings 
available. 

e If the COPY statement statement was used, 
execute the IEBPTIPCH utility program to. 
obtain a copy of the PLS member specified 
in the COPY statement. 

e Make sure that MSGLEVEL=(1,1) was 
specified in the JOB statement. 


IEU998I ASSEMBLY TERMINATELC, OPEN FAILED FOR DATA 


SET (ddname) 


Explanation: DD statement(s) for data 
set (s) SYSIN, SYSUT1, SYSUT2, SYSUT3, 
and/or SYSPRINT incorrect or missing. 


System Action: Assembly is terminated. 


Severity Code: 20 


Programmer Response: Probable user error. 
Supply missing DD statement (s) or make sure 
that information on CD statement (s) is 
correct; reassemble. If problem recurs, do 
the following before calling IBM: 

e Have the user source program, user macro 
definitions, and associated listings 
available. 

e If the COPY statement was used, execute 
the IEBPTPCH utility program to obtain a 
copy of the PLS member specified in the 
COPY statement. 

e Make sure that MSGLEVEL=(1,1) was 
specified in the JOB statement. 


IEU999I ASSEMBLY TERMINATED, jobname, stepname, 


unit address, device type, ddname, 
Operation attempted, error description 
(bytes 107 through 128 of the SYNALAF 
message buffer; this area is described in 


OS Data Management Macro Instructions. 


Explanation: Indicates a permanent I/0 
error. This message is produced by the 
SYNADAF macro instruction. 


System Action: Assembly is terminated. 


Severity Code: 20 


Programmer Response: Reassemble. If the 
problem recurs, do the following before 
calling IBM: 

e Have the user source program, user macro 
definitions, and associated listings 
available. 

e If the COPY statement was used, execute 
the IEBPTPCH utility program to oktain a 
copy of the PDS member specified in the 
COFY statement. 

® Make sure that MSGLEVEL=(1,1) was 
specified in the JOB statement. 


TXT Card Format 


The format of the TXT cards is as follows: 


Columns Contents 

12-2-9 punch 

-4 TXT 
Blank 

-8 Relative address of first 
instruction on card 

9-10 Blank 

11-12 Byte count -- number of 
bytes in information 
field (cc 17-72) 


AMN = 


13-14 Blank 

15-16 ESDID 

17-72 56-byte information field 

73-76 Deck ID (from first TITLE 
card) 

77-80 Card sequence number 


RLD Card Format 


The format of the RLD card is as follows: 


Columns Contents 
1 12-2-9 punch 
2-4 RLD 
5-10 Blank 
11-12 Data field count -- number 
of bytes of information in 
data field (cc 17-72) 
13-16 Blank 
17-72 Data field: 
17-18 Relocation ESDID 
19-20 Position ESDID 
21 Flag byte 
22-24 Absolute address to be 
relocated 
25-72 Remaining RLD entries. 
73-76 Deck ID (from first TITLE 
card) 
77-80 Card sequence number 


If the rightmost bit of the flag byte is 


set, the following RLD entry has the same 
Relocation ESDID and Position ESDID, and 
this information will not be repeated; if 
the rightmost bit of the flag byte is not 
set, the next RLD entry has a different 


Relocation ESDID and/or Position FSDID, and 


both ESDICDS will be recorded. 


For example, if the RLD Entries 1, 2, 
and 3 of the program listing (Appendix C) 
contain the following information: 
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Pos. Rel. 
ESDID ESDID Flag Address 


Entry 1 02 04 oc 000100 
Entry 2 02 04 0c 000104 
Entry 3 03 01 OC 000800 


Columns 17-36 of the RLD card would 
appear as follows: 






17 18 19 20 21 22 23 24]25 26 27 28129 30 31 32 33 34 35 36|37—=— 72 


| o0fo4foofoz]oo] oofoifoofoc]en]orfosfooforfoofos}oc} oofos}oo} | 


a § 
ESD 1D's 


Column: 












Address Addiess ESD ID's | Address blanks 





Flag Flag Flag 
(set) (not (not 
set) set) 


ESD Card Format 


The format of the ESD card is as follows: 


Columns Contents 
1 12-2-9 punch 
2-4 ESD 


5-10 Blank 

11-12 Variable field count -- 
number of bytes of information in 
variable field (cc 17-64) 


13-14 Blank 
15-16 ESDID of first SD, XD, CM, WX, 
PC, or ER in variable field 
17-64 Variable field. One to 
three 16-byte items of the 
following format: 
8 bytes -- Name, padded 
with blanks 
1 byte -- ESD type code 
The hex value is: 
00 SD 
01 LD 
02 ER 
04 PC*. 
05 CM 
06 XD (PR) 
OA WX 
3 bytes -- Address 
1 byte -- Alignment if XL; 
otherwise blank 
3 bytes -- Length, LDID, or 
blank 
65-72 Blank 
73-76 Deck ID (from first TITLE 
card) 
77-80 Card sequence number 
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END Card Format The items making the text are packed 
together, consequently only the last card 
The format of the END card is as follows: may contain less than 56 bytes of text in 
the variable field. The formats of a text 
Columns Contents card and an individual text item are shown 
in Figure 19. The contents of the fields 
1 12-2-9 punch within an individual entry are as follows: 
2-4 END ; 
5 Blank 1. Organization (1 byte) 
6-8 Entry address from operand 


of END card in source deck 
(blank if no operand) 

9-14 Blank 

15-16 ESDID of entry point (blank 
if no operand) 

17-32 Blank 


33 1 
34-43 Order number of the assembler: 
S360AS037. 


44-45 Version level of the assembler. 

46-47 Modification level of the 
assembler. 

48-49 Last two digits of the year in 
which the assembly was run. 

50-52 Julian day of the year in which 
the assembly was run. 

53-72 Normally not used. 

73-80 Deck ID and/or sequence number. 
The deck ID is the name field from 
the first named TITLE statement. 
The name can be one to eight 
alphameric characters long. If 
there is no name or the name is 
less than eight characters long, 
the remaining columns contain a 
card sequence number. (Columns 
73-80 of cards produced by PUNCH 
or REPRO statements do not contain 
a deck ID or a sequence number.) 


0 = non-data type 


1 data type 
Bits 1-3 (if non-data type): 
000 = space 
001 = control section 
010 = dummy control section 
011 = common 
100 = machine instruction 
101 = CCW 


Bit 1 (if data type): 
0 = no multiplicity 
1 = multiplicity (indicates 
presence of M field) 
Bit 2 (if data type): 

0 = independent (not a 
packed or zoned decimal 
constant) 
cluster (packed or 
zoned decimal constant) 
Bit 3 (if data type): 

0 = no scaling 
1 scaling (indicates pres- 
ence of S field) 


1 


Bit 4: 
0 
| 


name present 
hame not present 


Bits 5-7: 
Length of name minus one 


2. Address (3 bytes) - displacement from 
beginning of control section 
SYM Card Format 
3. Symbol Name (0-8 bytes) - symbolic 
If requested by the user, the assembler name of particular item 
punches out SYM cards with symbolic 
information concerning the assembled 
program. These cards can be used by the Note: The following fields are only 
TESTRAN routine or the TSO Test command present for data-type items. 


processor. The cards are located between 
the ESD and TXT cards. The format of SYM 4. 
cards is as follows: 


Columns Contents 
1 12-2-9 punch 
2-4 SYM ° 
5-10 Blank 
11-12 Variable field count -- 


number of bytes of text in 
variable field (cc 17-72). 
13-16 Blank 
17-72 Variable field (see belcw) 
73-76 Deck ID (from first TITLE 
card) 
77-80 Card sequence number 


The variable field (columns 17-72) ee 
contains up to 56 bytes of TESTRAN text. 


56 


Data Type (1 byte) - contents in 
he xadecimal 


00 = character 

04 = hexadecimal, L-type data 
08 = binary 

10 = fixed point, full 

14 = fixed point, half 

18 = floating point, short 
1C = floating point, long 
20 = A-type or Q-type data 
24 = Y-type data 

28 = S-type data 

2C = V-type data 

30 = packed decimal 

34 = zoned decimal 


Length (2 bytes for character, 
hexadecimal, or binary items; 1 byte 
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for other types) - length of data item 7. Scale -signed integer - S field (2 


minus 1 bytes) - present only for F, H, E, D, 
L, P and Z type data, and only if 
Multiplicity - M field (3 bytes) - scale is non-zero. 


equals 1 if not present 


Appendix B. Object Deck Output 56.1 


1 2 45 10 1112.13 16 17 


7273 #7677 ~~. 80 







Sequence 
Number 


SYM text - packed entries 






















Entry 
(complete or 
end portion) 


Entry 
(complete or 
head portion) 







N complete entries 


N 2 1 


Variable size entries 


Data 
: Mult. O 
Address Symbol Name fype Length ities Scale 
3 2 


Figure 19. SYM Card Format 
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Appendix C. Assembler F Program Listing 


The Assembler F listing shown in this Since there were no errors in the 
appendix results from assembling the source assembly, a diagnostic list was not 
program documented in an appendix to the OS produced. Each of the following pages 


Assembler Lanquage publication. For easy represents one printer-produced listing 
reference to the explanations that appear page. 


in the section "The Assembler Listing", the 
headings on the listing are numbered. 


@ 
EXAM @ 3) © @ © EXTERNAL SYMBOL DICTIONARY once 1 


SYMBOL TYPE ID ADDR LENGTH LD ID 14.56 10/13/71 


SAMPLR SD 01 000000 0003B8 





58 


EXAM 


O 


Loc 


000000 
000000 


SAMPLE PROGRAM 


OBJECT CODE 


47FO FOOA 


000004 05 


000005 
QOO00A 
00000E 
000010 
000010 
000014 
000000 
000018 
00001C 
000020 
000000 


C2C5C7C9D5 
90EC DONC 
05C0 


50D0 COB8 


‘9857 C390 


45E0 COBE 
9180 COBC 
4710 COBO 


ACDR1 ADLR2 STMT 


= 
[C0 ONNU SWAY 


= 


=o ot on 
Awnlwhd 


17 


57+ 
58+ 


SOURCE 


* 


«TYPEDEH 


YPECGK 


o* 

- ERROR1 
« ERROR2 
- ERROR3 
- ERROR4 


* 
* 


* 
SAMPLR 
BEGIN 
BEGIN 


STATEMENT 


PRINT DATA 
THIS IS THE MACRO DEFINITION 


MACRO 
MOVE &TO,&FROM 


DEFINE SETC SYMBOL 

LCLC &TYPE 

CHECK NUMBER OF OPERANDS 

AIF (N'&SYSLIST NE 2) .ERROR1 
CHECK TYPE ATTRIBUTES OF OPERANDS 


AIF . (T'&TO NE T‘&EFROM .ERROR2 


F010CT71 


AIF (T'&TO EQ 'C* OR T'ETO EQ 'G* OR T*ETO EQ °K‘). TYPECGK 
AIF (T'ETO EQ ‘D* OR T*ETO EQ 'E* OR T' ETC EQ 'H').TYPELEH 


AIF (T'&TO EQ 'F*) .MOVE 
AGO «ER OR3 
ANOP 


ASSIGN TYPE ATTRIBUTE TO SETC SYMBOL 


SETC T'&TO 
ANOP 


‘NEXT TWO STATEMENTS GENERATED FOR MOVE MACRC 


L&TYPE 2,&FROM 
ST&6TYPE 2,&T0 
MEXIT 


CHECK LENGTH ATTRIBUIES OF OPERANDS 


AIF (L°&TO NE L*&FROM OR L*&TO GT 256) . ERROR4Y 
NEXT STATEMENT GENERATED FOR MOVE MACRO 

MVC &TO,&FROM 

MEXIT 


ERROR MESSAGES FOR INVALID MOVE MACRO INSTRUCTIONS 


PAGE 1 


© 


10/13/71 


01000019 
01500019 
02000019 
02500019 
03000019 
03500019 
04000019 
04500019 
05000019 
05500019 
06000019 
06500019 
07000019 
07500019 
08000019 
08500019 
09000019 
09500019 
10000019 
10500019 
11000019 
11500019 
12000019 
12500019 
13000019 
13500019 
14000019 
14500019 
15000019 
15500019 
16000019 
16500019 
17000019 
17500019 
18000019 
18500019 
19000019 
19500019 
20000019 
20500019 
21000019 
21500019. 


MNOTE 1,‘ IMPROPER NUMBER OF OPERANDS, NO STATEMENTS GENERATED* 22000019 


MEXIT 


MNOTE 1,‘OPERAND TYPES DIFFERENT, NO STATEMENTS GENERATED‘ 


MEXIT 


MNOTE 1,‘ IMPROPER OPERAND TYPES, NO STATEMENTS GENERATED‘ 


MEXIT 


MNOTE 1,' IMPROPER OPERAND LENGTHS, NO STATEMENTS GENERATED‘ 


MEND 


MAIN ROUTINE 


CSECT 
SAVE (14,12) ,,# 
B 10(0,15) BRANCH AROUND ID 


pcs AL (5) 
pC = CLS _-_BEGIN' IDENTIFIER 
ST™ 14,12,12(13) SAVE REGISTERS 


BALR_ R12,0 ESTABLISH ADDRESSABILITY OF PROGRAM 
USING *,R12 AND TELL THE ASSEMBLER WHAT BASE TO USE 


st 13, SAVE13 


22500019 
23000019 
23500019 
24000019 
24500019 
25000019 
25500019 
26000019 
26500019 
27000019 
27500019 
28000019 


28500019 
29000019 
29500019 


LM R5,R7,=A (LISTAREA, 16, LISTEND) LOAD LIST AREA PARAMETERS 30000019 


USING LIST,RS REGISTER 5 POINTS TO THE LIST 
BAL R14,SEARCH FIND LIST ENTRY IN TABLE 


™ SWITCH,NONE CHECK TO SEE IF NAME WAS FOUND 


BO NOTTHERE BRANCH IF NOT 


USING TABLE,R1 REGISTER 1 NOW POINTS TO TABLE ENTRY 


MOVE TSWITCH,LSWITCH MOVE FUNCTIONS 
NEXT STATEMENT GENERATED FOR MOVE MACRO 


30500019 
31000019 
31500019 
32000019 
32500019 
33000019 
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EXAM SAMPLE PROGRAM PAGE o 2 
LOC OBJECT CODE ACDR1 ALER2 STMT SOURCE STATEMENT , FO010CT71 10/13/71 

000024 D200 1003 5008 00003 00008 72+ MVC TSWITCH, LSWIICH @ 
73 MOVE TNUMBER, LNUMBER FROM LIST ENTRY 33500019 
7T4+* NEXT STATEMENT GENERATED FOR MOVE MACRO 

00002A D202 1000 5009 00000 00009 75+ MVC TNUMBER,LNUMBER 
76 MOVE TADDRESS,LADDRESS TO TABLE ENTRY 34000019 
7T71+# NEXT TWO STATEMENTS GENERATED FOR MOVE MACRC 

000030 5820 500C 0000C 78+ L 2,LACDRESS 

000034 5020 1004 00004 79+ ST 2,TADDRESS 

000038 8756 C008 00018 80 LISTLOOP BXLE R5,R6,MORE LCOP THROUGH THE LIST 34500019 

00003C DSEF C240 COFO 00250 00100 81 CLC TESTTABL (240) , TABLAREA 35000019 

000042 4770 CO7C 0008C 82 BNE NOTRIGHT 35500019 

000046 DS5F C330 C1E0 00340 001F0 83 CLC TESTLIST (96) ,LISTAREA 36000019 

00004C 4770 CO7C 0008C 84 BNE NOTRIGHT 36500019 
85 WTO ‘ASSEMBLER SAMPLE PROGRAM SUCCESSFUL ° 37000019 

000050 86+ CNOP 0,4 

000050 4510 c0é6éCc 0007C 87+ BAL 1,1HBOOOSA BRANCH AROUND MESSAGE 

000054 0027 88+ cc AL2 (IHB0005-*) MESSAGE LENGTH 

000056 0000 89+ pe B*0000000000000000" MCSFLAGS FIELE 

000058 CITE2E2C5D4C2D3C5 90+ bc C*'ASSEMBLER SAMPLE PROGRAM SUCCESSFUL" MESSAGE 


000060 DIYOE2C1D4D7D3C5 
000068 4OD7D9D6C7DIC 1D4 
000070 4OE2E4C3C3C5E2E2 
000078 C6E4D3 


000073 91+IHBO005 EQU * 

00007C 92+IHBOOOSA DS OH 

00007C 0A23 93+ SVC 35 ISSUE SVC 

00007E 58D0 COB8 000C8 94 EXIT L R13, SAVE13 37500019 
95 RETURN (14,12) ,RC=0 38000019 

000082 98EC DONC 0000Cc 96+ LM 14,12,12(13) RESTORE THE REGISTERS 

000086 41F0 0000 00000 97+ LA 15,0(0,0) LOAD RETURN CODE 

00008A O7FE 98+ BR 14 RETURN 
99 * 38500019 
100 NOTRIGHT WTO ‘ASSEMBLER SAMPLE PROGRAM UNSUCCESSFUL' 39000019 

00008C 101+ CNOP 0,4 

00008C 4510 COAA OOOBA 102+NOTRIGHT BAL 1,1HBO007A BRANCH AROUND MESSAGE 

000090 0029 103+ pe AL2 (IHB0007-*) MESSAGE LENGTH 

000092 0000 104+ be B'0000000000000000" MCSFLAGS FIELD 

000094 CIE2ZE2C5SD4C2D3C5 105+ pc C'ASSEMBLER SAMPLE PROGRAM UNSUCCESSFUL* MESSAGE 


00009C DI“OE2ZC1D4D7ID3C5 
O000A4 4OD7D9DECTDIC1D4 
OOOOAC S4OEYUDSE2ZE4C3C3CS5 - 
0000B4 E2E2C6E4&D3 


0000B9 106+IHBOO07 EQU * 
0O00BA 107+IHBOOO7A DS OH 
O000BA 0A23 108+ svc 35 ISSUE SVC 
OOO0O0BC 47FO CO6E OOO7E 109 B EXIT 39500019 
0000CO 9680 5008 00008 110 NOTTHERE OL LSWITCH,NONE TURN ON SWITCH IN LIST ENTRY 40000019 
0000C4 47FO C028 00038 111 B LISTLOOP GO BACK AND LOOP 40500019 
0000C8 00000000 112 SAVE13 DC F‘O° 41000019 
0000cc 00 113 SWITCH pe x*oo'. 41500019 
000080 114 NONE EQU x*80* 42000019 
115 * 42500019 
116 * BINARY SEARCH ROUTINE 43000019 
117 * 43500019 
0000CcD 00 
QOO00CE 947F COBC o0o00cc 118 SEARCH NI SWITCH, 255-NONE TURN OFF NOT FOUND SWITCH 44000019 
0000D2 9813 C39C 003AC 119 LM R1,R3,=F"'128,4,128" LOAD TABLE PARAMETERS 44500019 
0000D6 4111 COEO 000FO 120 - LA R1, TABLAREA- 16 (R1) GET ADDRESS CF MICDLE ENTRY 45000019 
QOOODA 8830 0001 00001 121 LOOP SRL R3,1 DIVIDE INCREMENT EY 2 45500019 
QOO0ODE D507 5000 1008 00000 00008 122 CLC LNAME, TNAME COMPARE LIST ENTRY WITH TABLE ENTRY 46000019 
OQ0O00E4 4720 COE4 OOOF4 123 BH HIGHER BRANCH IF SHOULC EE HIGHER IN TABLE 46500019 
OO00E8 078E 124 BCR 8,R14 EXIT IF FOUND 47000019 
125 SR R1,R3 OTHERWISE IT IS LOWER IN THE TABLE X47500019 
OOOOEA 1B13 SO SUBTRACT INCREMENT 48000019 
OOOOEC 4620 COCA O0ODA 126 BCT R2, LOOP LOOP 4 TIMES 48500019 
OOOOFO 47F0 COEA OOOFA 127 B NOTFOUND ARGUMENT IS NOT IN THE TABLE 49000019 
OOOOF4 1A13 128 HIGHER AR R1,R3 ADD INCREMENT . 49500019 
OO0OF6 4620 COCA OOOLA 129 BCT R2, LOOP LOOP 4 TIMES 50000019 
OOOOFA 9680 COBC 000CC 130 NOTFOUND OI SWITCH, NONE TURN ON NOT FOUND SWITCH 50500019 
OOO0OFE O7FE 131 BR R14 EXIT 51000019 
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SAMPLE PROGRAM PAGE 


OBJECT CODE ACDR1 ADDR2 STMT SOURCE STATEMENT F010CT71 10/13/71 


132 * 51500019 
133 * THIS IS THE TABLE 52000019 
134 * §2500019 
000100 135 DS OD 53000019 
000100 0000000000000000 136 TABLAREA DC XL8*0',CL8*ALPHA* §3500019 
000108 C1D3D7C8C1404040 
000110 0000000000000000 137 pc XL8'0',CL8*BETA* 54000019 
000118 C2C5E3C140404040 
000120 0000000000000000 pc XL8'0*',CL8 ‘DELTA ' 54500019 
000128 C4C5D3E3C1404040 
000130 0000000000000000 Dc XL8'0',CL8*EPSILON! 55000019 
000138 C5D7E2C9D3DE6D540 
000140 0000000000000000 Dc XL8'0',CL8°ETA* ; 55500019 
000148 C5E3C140404040480 
000150 0000000000000000 pc XL8'0O*,CL8°GAMMA* 56000019 
000158 C7C1ID4D4C1404040 
000160 0000000000000000 pc XL8'0',CL8*IOTA* 56500019 
000168 C9ID6E3C140404040 
000170 0000000000000000 DC XL8'0',CL8"*KAPPA‘ 57000019 
000178 D2C1D7D7C1404040 
000180 0000000000000000 144 DC XL8'0',CL8 *LAMBDA* 57500019 
000188 D3C1D4C2C4C14040 
000190 0000000000000000 145 DC XL8'0',CL8'MU® 58000019 
000198 D4EX4O4OKOKOKHOuO 
0001A0 0000000000000000 146 pc XL8'0',CL8 *NU* 58500019 
0O001A8 DS5SEX4O4O4O4O4O4O 
0001B0 0000000000000000 147 pc XL8'0*,CL8 *OMICRON® 59000019 
0001B8 DED4EC9IC3D9DEDS40 
0001C0 0000000000000000 148 DC XL8'0',CL8°PHI'® 59500019 
0001C8 D7C8C94O4O4O4OKO 
0001n0 0000000000000000 149 DC XL8'O',CL8*SIGMA' 60000019 
0001D8 E2C9C7DUC14ONO4O 
0001E0 0000000000000000 150 pc XL8'0',CL8*ZETA* 60500019 
0001E8 E9C5E3C140404040 
151 * 61000019 
152 * THIS IS THE LIST 61500019 
153 * 62000019 
0001FO D3C1D4C2CHC140 40 154 LISTAREA DC CL8* LAMBDA! ,X'0A‘', FL3*' 29* ,A (BEGIN) 62500019 
0001F8 0A00001D00000000 
000200 E9C5E3C 140404040 155 pe CL8' ZETA’ ,X"'05', FL3'5*,A (LOOP) 63000019 
000208 05000005000000LA 
000210 E3C8C5E3C 1404040 156 pe CL8*THETA' ,X'02', FL3'45* ,A (BEGIN) 63500019 
000218 0200002D00000000 
000220 E3C1E¥4O40UOKO4O 157 DC CL8'TAU',X*00' , FL3*0* ,A (1) 640000 19 
000228 0000000000000001 
000230 D3C9IEZE340404040 158 bc CL8* LIST’ ,X* 1F* , FL3' 465° ,A (0) 64500019 
000238 1F0001D100000000 
000240 C1D3D7C8C 1404040 159 LISTEND DC CL8' ALPHA' ,X'00',FL3" 1°,A (123) 650000 19 
000248 000000010000007B 
160 * 65500019 
161 * THIS IS THE CONTROL TABLE 66000019 
162 * ; 66500019 
000250 163 Ds OD 67000019 
000250 0000010000000078 164 TESTTABL DC FL3' 1° ,x'00*,A(123) ,CL8*ALPHA’ 67500019 
000258 C1D3D7C8C1404040 
000260 0000000000000000 165 “pe XL8'0*",CL8* BETA‘ 680000 19 
000268 C2C5E3C140404040 
000270 0000000000000000 166 pe XL8'0O*,CL8"DELTA' 685000 19 
000278 C4C5D3ZE3C1404040 
000280 0000000000000000 167 DC XL8'0O"',CL8* EPS ILON® 690000 19 
000288 C5D7E2C9D3D6L540 
000290 0000000000000000 168 Dc XL8'0*,CL8" ETA' 695000 19 
000298 C5E3C14040404040 
0002A0 0000000000000000 169 DC XL8°0O"',CL8"GAMMA' 700000 19 
0002A8 C7C1D4D4ECI4O4UN4O 
0002B0 0000000000000000 170 DC XL8'0*,CL8* IOTA‘ 705000 19 
0002B8 C9D6E3C140404040 
0002CO0 0000000000000000 171 pc XL8'0',CL8" KAPPA‘ 710000 19 
0002C8 D2C1D7D7C1404040 
0002D0 00001D0A00000000 172 pc FL3'29",X*OA*,A (BEGIN) ,CL8*LAMBDA‘* ’ 71500019 
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EXAM 


O 


LOC 


0002D8 
0002E0 
0002E8 
0002F0 
0002F8 
000300 
000308 
000310 
000318 
000320 
000328 
000330 
000338 


000340 
000348 
000350 
000358 
000360 
000368 
000370 
000378 
000380 
000388 
000390 
000398 


000000 
000001 
000002 
000003 
000005 
000006 
000007 
00000C 
00000D 
00000E 
00000F 


000000 
000000 
000008 
000009 
00000C 


000000 
000000 
000003 
000004 
000008 
000000 


0003A0 
0003A8 
0003AC 
0003B4 
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SAMPLE PROGRAM 


OBJECT CODE 


D3C1D4C2C4C14040 
0000000000000000 
D4EL4OUONOOUOKO 
0000000000000000 
D5E4404040404040 
0000000000000000 
D6D4CIC3DIDEL540 
0000000000000000 
D7C8C9#O4O4O4O40 
0000000000000000 


‘E2C9CTD4UCTHO4O4O 


00000505000000DA 
EICSE3C 140404040 


D3C1ID4C2CHC 14040 
0A00001D00000000 
ESC5E3C 140404040 
05000005000000Lr~A 
E3C8C5E3C 1404040 
8200002D00000000 
E3C1E44040404040 
8000000000000001 
D3C9E2E340404040 
9F0001D100000000 
C1D3D7C8C 1404040 
0000.00010000007B 


000001F000000010 
00000240 
0000008000000004 
00000080 


© 


ADDR1 ADDR2 STMT 


173 
174 
175 
176 


477 


178 


179 
180 
181 
182 


183 
184 
185 
186 
187 


188 
189 
190 
191 
192 
193 
194 
195 
196 
197 
198 
199 
200 
201 
202 
203 
204 
205 
206 
207 
208 
209 
210 
211 
212 
213 
214 
215 
216 
217 
218 


219 
220 


4) 


SOURCE STATEMENT 


* 
* 
* 


TESTLIST 


RO 

R1 

R2 

R3 

R5 

R6 

R7 

R12 

R13 

R14 

R15 

* 

* 

* 

LIST 
LNAME 
LSWITCH 
LNUMBER 
LADDRESS 
* 


* 
* 

TABLE 
TNUMBER 
TSWITCH 
TADDRESS 
TNAME 


pc 
bc 
DC 
pe 
DC 
DC 


© 


FO 10CT71 


XL8'0',CL8 "MU 

XL8'0',CL8'NU* 
XL8'0",CL8*OMICRON' 
XL8'0',CL8'PHI® 

XL8'0', CL8"SIGMA‘* 

FL3'5", X05", A (LOOP) ,CL8* ZETA' 


THIS IS THE CONTROL LIST 


Dc 
pc 
pc 
DC 
pc 


DC 


THESE 


EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
ECU 
EQU 
EQU 
EQU 


CL8 "LAMBDA! ,X'0A', FL3' 29* ,A (BEGIN) 
CL8'ZETA',X'05',FL3'5",A (LOOP) 
CL8'THETA' ,X'82",FL3°45',A (BEGIN) 
CL8'TAU' ,X*80", FL3°0",A (1) 
CL8'LIST' ,X'9F*, FL3"465" ,A (0) 


CL8' ALPHA' ,X'00", FL3‘ 1",A (123) 


ARE THE SYMBOLIC REGISTERS 


T IS IS THE FORMAT DEFINITION OF LIST ENTRYS 


DSECT 
DS 
DS 
DS 
DS 


CL8 
Cc 
FL3 
F 


THIS IS THE FORMAT DEFINITION OF TABLE ENTRYS 


DSECT 
DS 

DS 
DS 
DS 
END 


’ FL3 


Cc 

F 
CL8 
BEGIN 


=A (LISTAREA, 16,LISTEND) 


=F'128,4,128° 


PAGE 4 


© 


10/13/71 


72000019 
72500019 
73000019 
73500019 
74000019 
74500019 


75000019 
75500019 
76000019 
76500019 


770000 19 
77500019 
780000 19 
78500019 
790000 19 


79500019 
80000019 
80500019 
81000019 
81500019 
82000019 
82500019 
83000019 
83500019 
84000019 
84500019 
85000019 
85500019 
86000019 
86500019 
87000019 
87500019 
88000019 
88500019 
89000019 
89500019 
90000019 
90500019 
91000019 
91500019 
92000019 
92500019 
93000019 
93500019 
94000019 
94500019 


EX AM RELOCATION CICTIONARY PAGE 


© 0 0 @ © 


POS.1D REL.ID FLAGS ACDRESS 
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01 01 000 1FC 
01 01 00020C 
01 00021C 
01 0002D4 
01 000334 
01 00034C 
01 00035C 
01 00036C 
01 0003A0 
01 0003A8 
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“®@ © 0 © 


LEN VALUE 


SYMBOL 


BEGIN 
EXIT. 
HIGHER | 
1HB0005 
IHBOO0SA 

- THBO007 ; 
IHB0007A 
LADDRESS 
LIST 
LISTAREA 
LI STEND 
LISTLOOP 
LNAME 
LNUMBER 
LOOP 
LSWITCH 
MORE 
NONE 
NOTF OUND 
NOTRIGHT 
NOTTHERE 
RO 
R1 
R12 
R13 > 
R14 
R15 
R2 
R3 
R5 
R6 
R7 
SAMPLR 
SAVE13 
SEARCH 
SWITCH 
TABLAREA 
TABLE 
TACDRESS 
TESTLIST 
TESTTABL 
TNAME 
TNUMBER 
TSWITCH 


00004 
00004 
00002 
00001 
00002: 
00001: 
00002 
00004 
00001: 
00008 
00008 
00004 
00008 
00003 
00004 
00001 
00004 
00001 
00004 
00004, 
00004 
00001 
00001 
00001 
00001 
00001 
00001 
00001 
00001 
00001- 
00001 
00001 
00001 
00004" 
00004 
00001 
00008 ° 
00001 
00004 
00008 
00003 
00008 
00003 
00001 


000000 
00007E 


OOOOF4. 


00007B 
00007C 
0000B9 
0000BA 
00000c 
000000 


0001F0. 


000240 
000038 
000000 
000009 
QOOODA 
000008 


000018 


000080 
OOOOFA 
00008C 
0000C0 
000000 
000001 
00000C 
00000D 
O0000E 
OO0000F 


000002 


000003 
000005 
000006 
000007 
000000 
0000c8 
0000CE 
0000CC 
000100 
000000 
000004 
000340 
000250 
000008 
000000 
000003 


CEFN 


00057 


00094: 


00128 
00091 
00092 
00106 
00107 
00209 
00205 
00154 
00159 
00080 
00206 
00208 
00121 
00207 
00066 
00114 


00130 


00102 
00110 


°00191 


00192 
00198 
00199 
00200 
00201 
00193 
00194 
00195 
00196 
00197 
00055 
00112 
00118 
00113 
00136 
00213 
00216 
00182 
00164 
00217 
00214 
00215 


2) 


REFERENCES 


0154 


0109 
0123 
0088 
0087 
0103 
0102 
0078 
0065 
0064 
0064 
0111 
0122 
0075 
0126 
0072 
0080 
0067 
0127 
0082 
0068 


0069 
0061 
0094 
0066 


0126 
0119 
0064 
0080 
0064 


0063 
0066 
0067 
0081 
0069 
0079 
0083 
0081 
0122 
0075 
0072 


0156 


0083 
0219 


0129 
0110 


0110 
0084 
0119 
0062 
0124 
0129 


0121 
0065 


0094 


0118 
0120 


NO STATEMENTS FLAGGED IN THIS ASSEMBLY 


*STATISTICS* 
*OPTIONS IN EFFECT* 
350 PRINTED LINES 


64 wri 2h, aha ate tt 


SOURCE RECORDS (SYSIN) 


LIST, DECK, NOLOAD, NORENT, XREF, NOTEST, ALGN, OS, NOTERM, LINECNT = 70 


CROSS-REFERENCE 


0172 


0219 


0155 


0118 


0120 
0131 


0125 
0080 


0130 


189 


0182 


0178 


0130 


0120 


0128 


0184 0218 


0183 


0125 0128 


SOURCE RECORDS (SYSLIB) 


833 
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Appendix D. Dynamic Invocation of the Assembler 


The Assembler can be invoked by a problem 
program at execution time through the use 
of the CALL, LINK, XCTL, or ATTACH macro 
instructions. If the xCTL macro 
instruction is used to invoke the 
Assembler, then no user opticns may be 
stated. The Assembler will use the 
standard default, as set during system 
generation, for each option. 


If the Assembler is invoked by CALL, 
LINK, or ATTACH, the user may suprly: 
1) The Assembler options 


2) The ddnames of the data sets to be used 
during processing 


[symbol } IEUASM, (optionlist 





[,ddnamelist] ), VL 


LINK | EP=IEUASM, 


ATTACH PARAM=(optionlist 


[,ddnamelist]), VL=1 


EP - specifies the symbolic name of the 
Assembler. The entry point at which 
execution is to begin is determined by 
the control program (from the library 
directory entry). 


PARAM - specifies, aS a sublist, address 
parameters to ke passed fron the 
problem program to the Assembler. ‘The 
first word in the address rarameter 
list contains the address of the 
option list. The second word contains 
the address of the ddname list. 


opticnlist - specifies the address of a 
variable length list containing the 
options. This address must be written 
even if no option list is prcevided. 


The option list must begin ona 
halfword boundary. The first two 
bytes contain a count of the number of 
bytes in the remainder of the list. 

If no options are specified, the count 
must be zero. The option list is free 
form with each field separated by a 
comma. No blanks or zeros should 
appear in the list. 


ddnamelist - specifies the address of a 
variable length list containing | 
alternate ddnames for the data sets. 
used during compiler processing. If 
standard ddnames are used, then this 
operand may be omitted. ° 


The ddname list must begin on a halfword 
boundary. The first two bytes ccntain a 
count of the number of bytes in the 
remainder of the list. Each name of less 
than eight bytes must be left-justified and 
padded with Elanks. If an alternate ddname 
is omitted, the standard name will ke 
assumed. If the name is omitted within the 
list, the 8-byte entry must contain Linary 
zeros. Names can be omitted frem the end 
merely by shortening the list. The 
sequence of the 8-byte entries in the 
ddname list is as follows: 


Entry Alternate Name 


not applicable 
not applicable 
not applicable 
SYSLIB 

SYSIN 

SYSPRINT 
SYSFUNCH 
SYSUT 1 

SYSUT2 

SYSUT3 

SYSGC 

SYSTERM 


=— = oa 
NOB OW DANHMNLWNH w= 


VL - specifies that the sign bit is to tLe 
set to 1 in the last word of the 
address parameter list. 
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‘an errcer message, 


Appendix E. The SYSTERM Listing 


The SYSTERM data set is designed to give 
the user of a remote terminal under the 
Time Sharing Option (TSO) quick access to 
the assembler diagnostics. It lists the 
diagnosed statement immediately fcllcwed by 
which tells the 
programmer what is wrong with the statement 
that has been flagged. To help identify 
the position of the statement in the 
program, SYSTERM also has facilities for 
printing the line number field (NUM option) 
and the statement number assigned by the 


-assembler in front of the flagged 


Statement. (STMT option). 

The Assembler option TERM specifies that 
the assembler will write diagnostic 
information on the SYSTERM data set. 
the programmer does not want the line 
number to be written, he should alse 
specify the NONUM option. To prevent the 
statement number on the listing from being 
printed, he should specify the NOSIMT 
option in the PARM field of the EXEC card. 


If 


The format of the flagged statement on 
SYSTERM is: : 


Source record(s) 
(columns 1-72 of 

the source statement 
lines) 


Statement No 
(option STMT) 
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If a statement contains continuation 
lines it will occupy several lines on the 
listing, each identified by a line numker 
(if option NUM is in effect). Ifa 
statement in error is discovered during the 
expansion of a macro, or of any inner macro 
called by the outer macro, the first line 
of the outer macro is listed before the 
flagged statement. If a statement is 
flagged during open code conditional 
assembly, the first line of the model 
statement will be listed before the 
Statement in error. 


Figures 20 and 21 illustrate the content 
and format of SYSTERM outrut. Figure 20 
shows the source statement section of a 
SYSPRINT listing, and Figure 21 shows the 
SYSTERM listing produced during the same 
assembly. This example exemplifies the 
rules given above. Cptions TERM, NUM, and 
SIMT have been in effect during this 
assembly. 


The SYSTERM listing starts with the 
statement ASSEMBLER (F) CCNE. At the end 
of the listing some diagnostic information 
is given: nnn STATEMENTS FLAGGED IN THIS 
ASSEMBLY, which indicates the total numker 
of source statements in error, and nn WAS 
HIGHEST SEVERITY CCLE, which specifies the 
Maximum severity code encountered. This 
figure is equal to the return ccde passed 
by the assembler to the supervisor. 


Loc 


000000 


cocccc 
cocccc 
000004 
ccccCco 


000006 


oocooa 


OOOOQOE 
000012 
caccle 
OOOOLA 
lelelele} Oe 


cocozc 


caco22 
ooco2e 


000028 


o0002C 


coccdz 
000003 
000004 
cocccc 


Figure 20. 


OBJECT CODE 


scec DCCC 
05CO 


0000 OCcdO 
eee ERRCR *ee 


cccc ocoo 

| er ERROR #ex 
5840 CO2z 

5043 0000 

413C 3C04 

1923 


4770 COOC 


cccc 
##% ERROR *#% 


98EC DCCC 
C7FE 
00000000 


OOOOOOEA 
*ee ERROR *%* 


ADDR1 ADDR2 


ccccc 


ccccc 


00000 
occ28 
00000 
CCCO4 


00012 


Q000C 


STMT SOURCE STATEMENT FOLOCT71 
1 MACRO 
2 GENF &P,EL 
3 LCLA &K 
4 LOOP ANOP 
5 &K SETA EK41 
€ GPEL(EK) CC FEL (eK)? 
7 AIF (&K LT N*EL).LCCP 
8 .CCNE MEND 
9 GELC &€ 
LC SAMPL2 C SECT ; ‘ 
ll SAVE (14912) ALL REGS ARE SAVEC IN SLPERVISCR SAVEARE?F 
12+ cs OF 
13+ STF 14512912(13) SAVE REGISTERS 
14 BALR) R120 
15 USING 4)R1Z SET LP BASE REGISTER 
16 &¢ SeTc "ef 
17 L R2sEND EAC CF AREA 
18 LA R34 TEIS IS A CUMMY COMMENT 
TC SHCW A 
STATEMENT CCNTAINING TOC 
MANY CONTINLATICN CARDS 
1S L R49F0 ZERC CONSTANT FOR RESETTING AREA 
20 Loop ST R4eC(R3) 
21 LA R394(,R3) RESET AREA A 
22 CR R2 RB 
23 BNE Loop 
24 AIF (*A* EQ *Q*).GO0 
25 SR 6Cy,EC OPEN COCE MODEL STATEMENT 
WITH A CCNTINUATICN CARE 
SR B,yB OPEN CODE MODEL STATEMENT 
WITF A CONTINUATION CARD 
2é .GO RETURN (14912) EXET FROM RCLTINE 
27+ LM 14,12212(13) RESTORE THE REGISTERS 
2e+ BR 14 RETURN 
29 * 
30 # CONSTANTS AND AREAS HAVE BEEN CPVITTED CN FURPCSE 
31 * 
32 GENF Fs0 GENERATION OF CONSTANTS 
33+FO oc Fect 
34 GENF 1,234 EXAMPLE OF MORE THAN CKE CARO 
IN A MACRO INSTRUCTION 
35+1234 oc Ft234¢ 
36 R2 ECU 2 
37 R3 EQuU 3 
38 R4 EQU 4 
39 R12 ECU 12 
40 ENC 


SYSPRINT Source Statement Listing 
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ASSEMBLER (fF) CONE 
17 


L R2,ENG END OF AREA 
IEUQ24 NEAR OPERAND COLUMN 4--UNDEFINED SYMBOL 
18 LA R3sA THIS IS A DUMMY CORMENT * 
TO SHOW A * 
STATEMENT CCNTAINING TOO * 


MANY CONTINUATION CARDS 
TEUO77 ILLEGAL CONTINUATION CARD 
TELO24 NEAR OPERAND CCLUMN 4~--UNCDEFINEC SYMBOL 
25 SR 6Q26Q OPEN CCDE MGCEL STATEMENT * 
SR B,6B OPEN CODE MODEL STATEMENT x 
WITH A CONTINUATION CARD 
IEU024 NEAR OPERAND COLUMN 1--UNDEFINED SYMBCL 
IEU024 NEAR OPERAND COLUMN 3-—-UNDEFINED SYMBOL 
34 GENF 1,234 EXAMPLE OF MORE THAN ONE CARD * 
35 +1234 oc Ft'234* 
TEUO1L6 INVALID NAME 
4 STATEMENTS FLAGGED IN THIS ASSEMBLY 
8 WAS HIGHEST SEVERITY CCDE 
*OPTIONS IN EFFECT* LIST, NODECKy NOLOADs NORENTs XREF» NOTESTs ALGNe OSs TERM, NUMy STMTs LINECNT = 70 


Figure 21. SYSTERM Assembly Output Listing 
(Produced for the source statements shown in Figure 20.) 
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IEU095 


ILEU096 


[EU097 


ampersand (&) followed by 1-7 letters 
and/or numbers first of which must be a 
letter), or statement following ‘MACRO® is 
not a valid prototype statement. 


Severity Code: 12 


Programmer Response: Make sure the source 

code is correct and reassemble if 

necessary. If the problem recurs, 
following before calling IBM: 

e Have the user source program, user macro 
definitions and associated listing 
available. 

e If the COPY statement was used, execute 
the IEBPTPCH utility program to obtain a 
copy of the PDS member specified in the 
COPY statement. 


do the 


ENTRY TABLE OVERFLOW 


Explanation: Number of ENTRY symbols, 
i.e., ENTRY instruction operands, exceeds 
100. 


Severity Code: 8 


Programmer Response: Make sure the source 
code is correct and reassemble if 
necessary. If the problem recurs, do the 
following before calling IBM: 

e Have the user source program, user macro 
definitions and associated listing 
available. 

e If the COPY statement was used, execute 
the IEBPTPCH utility program to obtain a 
copy of the PDS member specified in the 
COPY statement. 


MACRO INSTRUCTION OR PROTOTYPE OPERAND 
EXCEEDS 255 CHARACTERS IN LENGTH 


Severity Code: 12 


Programmer Response: Make sure the source 
code is correct and reassemble if 
necessary. If the problem recurs, 
eel teveng before calling IBM: 
Have the user source program, user macro 
definitions and associated listing 
available. 

e If the COPY statement was used, execute’ 
the IEBPTPCH utility program to obtain a 
copy of the PDS member specified in the 
COPY statement. 


do the 


INVALID FORMAT IN MACRO INSTRUCTION OPERAND 
OR PROTOTYPE PARAMETER 


Explanation: This message can be caused 


by: 


1. Illegal “=". 

1. A single "&" appears somewhere in the 
Standard value assigned to a prototype 
keyword parameter. 

3. First character of a prototype parameter 
is not "&é". 

4. Prototype parameter is a subscripted 
variable symbol. 


IEU098 


IEU099 


IEU 100 


5. Invalid use of alternate format in 
prototype statement, e.g., 


10 16 71 
PROTO &A,&B, 
or 
PROTO &A,&B, x 
EC 


6. Unintelligible prototype parameter, 
e.g., “6A*" or “EAEE." 

7. Illegal (non-assembler) character 
appears in prototype parameter or macro 
instruction operand. 


Severity Code: 12 


Programmer Response: Make sure the source 
code is correct and reassemble if 
necessary. If the problem recurs, do the 
following before calling IBM: 

e Have the user source program, user macro 
definitions and associated listing 
available. 

e If the COPY statement was used, execute 
the IEBPTPCH utility program to obtain a 
copy of the PDS member specified in the 
COPY statement. 


EXCESSIVE NUMBER OF OPERANDS OR PARAMETERS 


Explanation: Either the prototype has more 
than 200 parameters, or the macro 
instruction has more than 100 operands. 


Severity Code: 11 


Programmer Response: Make sure the source 
code is correct and reassemble if 
necessary. If the problem recurs, do the 
following before calling IBM: 

e Have the user source program, user macro 
definitions and associated listing 
available. 

e If the COPY statement was used, execute 
the IEBPTPCH utility program to obtain a 
copy of the PDS member specified in the 
COPY statement. 


POSITIONAL MACRO INSTRUCTION OPERANT, 
PROTOTYPE PARAMETER OR EXTRA COMMA FOLLOWS 
KEYWORD 


Severity Code: 12 


Programmer Response: Make sure the source 
code is correct and reassemble if 
necessary. If the problem recurs, do the 
following before calling IBM: 

e Have the user source program, user macro 
definitions and associated listing 
available. 

e If the COPY statement was used, execute 
the IEBPTPCH utility program to obtain a 
copy of the PDS member specified in the 
COPY statement. 


STATEMENT COMPLEXITY EXCEEDED 
Explanation: More than 32 operands ina 


DC, DS, DXD, or literal DC, or more than 50 
terms ina statement. 


Severity Code: 8 
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IEU101 


IEU102 


' 1EU 103 
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Programmer Response: Make sure the source 
code is correct and reassemble if 
necessary. If the problem recurs, do the 
following before calling IBM: 

e Have the user source program, user macro 
definitions and associated listing 
available. 

e If the COPY statement was used, execute 
the IEBPTPCH utility program tc cbtain a 
copy of the PDS member specified in the 
COPY statement. 


EOD ON SYSIN 


Explanation: EOD before END card. 


Severity Code: 12 


Programmer Response: Make sure the source 
code is correct and reassemble if 
necessary. If the problem recurs, 
following before calling IBM: 

e Have the user source program, user macro 
definitions and associated listing 
available. 

e If the COPY statement was used, execute 
the IERPTPCH utility program tc cbtain a 
copy of the PDS member specified in the 
COPY statement. 


dc the 


INVALIE OR ILLEGAL ICTL 


Explanation: The operands of the ICIL are 
out of range, or the ICTL is not the first 
statement in the input deck. (Assembly is 
terminated and further input is igncred.) 


Severity Code: 16 


Programmer Response: Make sure the source 
code is correct and reassemble if 
necessary. If the problem recurs, 
following before calling IBM: 

e Have the user source program, user macro 
definitions and associated listing 
available. 

e If the COPY statement was used, execute 
the IEBPTPCH utility program tc cbtain a 
copy of the PDS member specified in the 
COPY statement. 


dc the 


ILLEGAL NAME IN OPERAND FIELD OF COPY CARD 


Explanation: Syntax error, e.g., symbol 
has more than 8 characters or has an 
illegal character. 


Severity Code: 12 


Programmer Response: Probable user error. 
Make sure the source code is correct and 
reassemble if necessary. If the problem 
recurs, do the following before calling 
IBM: 

e Have the user source program, user macro 
definitions, and associated listings 
available. 

e If the COPY statement was used, execute 
the IEBPTPCH utility program tc obtain a 
copy of the PDS memker specified in the 
COPY statement. ; 


IEU104 COPY CODE NOT FOUND 


IEU105 


IEU106 


IEU 107 


Explanation: The operand of a COFY 
Statement specified COPY text which cannot 
be found in the library. 


Severity Code: 12 


Programmer Response: Prcbable user error. 
Make sure the source code is correct and 
reassemble if necessary. If proklem 
recurs, do the following before calling 
IBM: 

e Make sure 
included. 

e Make sure that MSGLEVEL= (1,1) was 
specified in the JOB statement. 

e Have the user source prcgram, user macro 
definitions, and associated listings 
available. 

e If the CCEY statement was used, execute 
the IEBPTFCH utility program to oktain a 
copy of the PDS member specified in the 
CCFY statement. 


the SYSLIB DD statement is 


EOD CN SYSTEM MACRO LIERARY 


Explanation: EOL before MENEC card. 


Severity Code: 12 


Frogrammer Response: Prokakle user error. 
Make sure the source code is correct and 
reassemble if necessary. If the problem 
recurs, do the following before calling 
IBM: 

e Have the user source program, user macro 
definitions, and associated listings 
available. 

e If the CCFY statement was used, execute 
the IEBPTPCH utility prcegram to obtain a 
copy of the PDS member specified in the 
CCFY statement. 


NOT NAME OF CSECT CR CXL 


Explanation: Referenced symbol expected to 
ke DSECT name, but it is not. 


Severity Code: 8 


ammer Res Make sure the source 
code is correct and reassemble if 
necessary. If the problem recurs, do the 
following before calling IBM: 

e Have the user source prcegram, user macro 
definitions and associated listing 
available. 

e If the CCFY statement was used, execute 
the IEBPTPCH utility prcegram to obtain a 
copy of the FLS member specified in the 
CCFY statement. 


INVALID OPERAND 


Explanation: Invalid syntax in DC operand, 
€.g-, invalid hexadecimal character in 
hexadecimal [C; operand string too long for 
X, B, C, DC's; operand unrecognizakle, 
contains invalid value, or incorrectly 
specified. 


IEU108 


IEU109 


TEU110 


Severity Code: 8 


Programmer Response: Probable user error. 

Make sure the source code is correct and 

reassemble if necessary. If the problem 

recurs, do the following before calling 

IBM: 

e Have the user source program, user macro 
definitions, and associated listings 
available. 

e If the COPY statement was used, execute 
the IEBPTPCH utility program to obtain a 
copy of the PDS member specified in the 
COPY statement. 


PREMATURE EOD 


Indicates an internal 
should not occur. 


Explanation: 
assembler error; 


Severity Code: 16 


Programmer Response: Reassemble; if the 
problem recurs, do the following before 
calling IBM: 

e Have the user source program, user macro 
definitions, and associated listings 
available. 

e If the COPY statement was used, execute 
the IEBPTPCH utility program to obtain a 
copy of the PDS member specified in the 
COPY statement. 

e Make sure that MSGLEVEL=(1,1) was 
specified in the JOB statement. 


PRECISION LOST 


Severity Code: 8 


Programmer Response: Probable user error. 
Make sure the source code is correct and 
reassemble if necessary. If the problem 
recurs, do the following before calling 
IBM: 

e Have the user source program, user macro 
definitions, and associated listings 
available. 

e If the COPY statement was used, execute 
the IEBPTPCH utility program to obtain a 
copy of the PDS member specified in the 
COPY statement. 


EXPRESSION VALUE TOO LARGE 


Explanation: Value of expression not in 
range than -16777216 to +16777215. 
Expressions in EQU and ORG statements are 
flagged if (1) they include terms 
previously defined as negative values, or 
(2) positive terms give a result of more 
than three bytes in magnitude. The error 
indication may be erroneous due to (1) the 
treatment of negative values as three-byte 
positive values, or (1) the effect of large 
positive values on the location counter if 
a control section begins with a START 
statement having an operand greater than 
zero, or a control section is divided into 
subsections. 


Severity Code: 8 


IEU111 


IEU112 


IEU113 


Programmer Response: Probable user error. 

Make sure the source code is correct and 

reassemble if necessary. If the problem 

recurs, do the following before calling 

IBM: 

e Have the user source program, user macro 
definitions, and associated listings 
available. 

e If the COPY statement was used, execute 
the IEBPTPCH utility program to obtain a 
copy of the PDS member specified in the 
COPY statement. 


OPEN FAILED FOR SYSGO, NOLOAD OPTION USED 


Explanation: DD statement incorrect or 


missing. 


Severity Code: 16 

Programmer Response: Probable user error. 

If necessary supply missing DD statement or 

make sure that information on DL statement 

is correct and reassemble. If proklem 
recurs, do the following before calling 

IBM: 

e Have the user source program, user macro 
definitions, and associated listings 
available. 

e If the COPY statement was used, execute 
the IEBPTPCH utility program to obtain a 
copy of the PDS member specified in the 
COPY statement. 

e Make sure that MSGLEVEL=(1,1) was 
specified in the JOB statement. 


OPEN FAILED FOR SYSPUNCH, NODECK OPTION 
USED 


Explanation: DD statement incorrect or 


missing. 


Severity Code: 16 


Programmer Response: Probable user error. 
If necessary supply missing DD statement or 
make sure that information on DD statement 
is correct and reassemble. If proklem 
recurs, do the following before calling 
IBM: 

e Have the user source program, user macro 
definitions, and associated Listings 
available. 

e If the COPY statement was used, execute 
the IEBPTPCH utility program to oktain a 
copy of the PDS member specified in the 
COPY statement. 

e Make sure that MSGLEVEL= (1,1) was 
specified in the JOB statement. 


OPEN FAILED FOR SYSTERM, NOTERM OPTION USED 


Explanation: DD statement incorrect or 


missing. 


Severity Code: 0 


Programmer Response: Probable user error. 
If necessary supply missing CD statement or 
make sure that information on DD statement 
is correct and reassemble. If problem 
recurs, do the following before calling 
IBM: 
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LEU116 


IEU117 


e Have the user source program, user macro 
definitions, and associated listings 
available. 

e If the COPY statement was used, execute 
the IEBPTPCH utility program to obtain a 
copy of the PDS member specified in the 
COPY statement. 

e Make sure that MSGLEVEL=(1,1) was 
specified in the JOB statement. 


ILLEGAL OPSYN 


Severity Code: 8 


Explanation: An OPSYN statement may be 
preceded only by an ICTL instruction or 
another OPSYN statement. 


Programmer Response: Probable user error. 

Make sure the source code is correct and 

reassemble if necessary. If the rrceblem 

recurs, do the following before calling 

IBM: 

e Have the user source program, user macro 
definitions, and associated listings 
available. 

e If the COPY statement was used, execute 
the IEBPTPCH utility program tc obtain a 
copy of the PDS member specified in the 
COPY statement. 


OPSYN TABLE OVERFLOW 


Explanation: No room exists in symrbcl 
table for this and following OPSYN 
definitions; generated operation codes may 
not be processed correctly. 


Programmer _ Response: Probable user error. 
Make sure the source code is correct and 
reassemble if necessary. If the problem 
recurs, do the following before calling 
IEM: 

e Have the user source program, user macro 
definitions, and associated listings 
available. 

e If the COPY statement was used, execute 
the IEBPTPCH utility program tc cbtain a 
copy of the PDS member specified in the 
COPY statement. 


IEU996I ASSEMBLY TERMINATED INSUFFICIENT STORAGE 


Explanation: One of the following: 
The partition or region size is less than 
the mimimum required ky the assembler. 

e The blocksize specified for the utility 
data sets is too large for available main 
stcrage. 


System Action: Assembly is terminated. 


Severity Code: 20 


IEU997I OPEN FAILED FOR SYSPRINT, NOLIST OPTION 
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USEC 


Explanation: DD statement incorrect or 
missing. 


System Action: Processing continues. 


Severity Code: 0 


Programmer Response: Prcebable user error. 
If necessary supply the missing [TL - 
statement or make sure that information on 
the DD statement is correct; reassemcble. 

If problem recurs, do the fcllowing before 

calling IBM: 

e Have the user source prcgram, user macro 
definitions, and associated listings 
available. 

e If the COPY statement statement was used, 
execute the IEBFTPCH utility program to 
obtain a copy of the PLS membker specified 
in the COPY statement. 

e Make sure that MSGLEVEL=(1,1) was 
specified in the JOE statement. 


IEU998I ASSEMBLY TERMINATECL, OPEN FAILEE FOR CATA 


SET (ddname) 


Explanation: DD statemrent(s) for data 
set(s) SYSIN, SYSUT1, SYSUT2, SYSUT3, 
and/or SYSPRINT incorrect or missing. 


System Action: Assembly is terminated. 


Severity Code: 20 


Programmer Response: Probable user error. 
Supply missing DD statement (Ss) or make sure 
that information on LL statement (s) is 
correct; reassemble. If problem recurs, do 
the following before calling IEM: 

e Have the user source program, user macro 
definitions, and associated listings 
available. 

e If the COPY statement was used, execute 
the IEBPTPCH utility program to obtain a 
copy of the FLS member specified in the 
COPY statement. 

e Make sure that MSGLEVEL= (1,1) was 
specified in the JOE statement. 


IEU999I ASSEMBLY TERMINATEL, jokname, stepname, 


unit address, device type, ddname, 
Operation attempted, error description 
(bytes 107 through 128 of the SYNALAF 
message buffer; this area is described in 


Explanation: Indicates a permanent I/C 
error. This message is produced by the 
SYNADAF macro instruction. 


System Action: Assembly is terminated. 


Severity Code: 20 


Programmer Response: Reassemble. If the 
proklem recurs, do the fcllowing before 
Saray IBM: 
Have the user source program, user macro 
definitions, and associated listings 
available. 

e If the COPY statement was used, execute 
the IEBPTFCH utility program to oktain a 
copy of the PDS member specified in the 
COPY statement. 

e Make sure that MSGLEVEL= (1,1) was 
specified in the JOB statement. 


TXT Card Format 


The format of the TXT cards is as fcllows: 


Columns Contents 

1 12-2-9 punch 

2-4 TXT 

5 Blank 

6-8 Relative address of first 
instruction on card 

9-10 Plank 

11-12 Byte count -- number of 
bytes in information 
field (cc 17-72) 

13-14 Plank 

15-16 ESDID 

17-72 56-bkyte information field 

73-76 Deck ID (from first TITLE 
card) 

77-80 Card sequence number 


RLD Card Format 


The format of the RLD card is as follows: 


Columns Contents 
1 12-2-9 punch 
2-4 RLC 
5-10 Blank 
11-12 Data field count -- number 
of bytes of information in 
data field (cc 17-72) 
13-16 Blank 
17-72 Cata field: 
17-18 Relocation ESDID 
19-20 Position ESDID 
21 Flag byte 
22-24 Aksolute address to ke 
relocated 
25-72 Remaining RLD entries 
73-76 Deck ID (from first TITLE 
card) 
77-80 Card sequence number 


If the rightmost bit of the flag byte is 


set, the following RLD entry has the same 
Relocation ESLCIL and Position ESDID, and 

this information will not be repeated; if 
the rightmost bit of the flag byte is not 
set, the next RLU entry has a different 
Relocation ESDID and/or Position ESDID, 
both ESLCILCs will ke recorded. 


For example, if the RLD Entries 1, 2, 
and 3 of the program listing (Appendix C) 
contain the following information: 


and 
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Pos. Rel. 

ESDID ESDID Flag Address 
Entry 1 02 04 oc 000100 
Entry 2 02 04 0c 000104 
Entry 3 03 01 0c 000800 


Columns 17-36 of the RID card wceuld 
appear as follows: 





Entry 2 







17 18 19 20 21 22 23 24125 26 27 28/29 30 31 32 33 34 35 36|37—m 72 


| 20 ]o4foofoz Too] ooforf ca}oc] eafoifos}ooforfoofosfoc}oofosjoof | 


ne u_ | 
ESD ID's 


Column: 









Address Address Address blanks 






Flag 
{not 
set) 


Flag 
(set) 


Flag 
(not 
set) 


ESD Card Format 


The format of the ESD card is as fcllows: 


Columns Contents 
1 12-2-9 punch 
2-4 ESD 
5-10 Blank 
11-12 Variable field ccunt -- 


number of bytes of information in 
variable field (cc 17-64) 


13-14 Blank 
15-16 ESDID of first SD, XD, CM, WX, 
FC, Or ER in variable field 
17-64 Variable field. Cne to 
three 16-byte items of the 
following format: 
8 kytes -- Name, padded 
with blanks 
1 byte -- ESD type code 
The hex value is: 
00 SD 
01 LC 
02 ER 
O04 PC 
05 CM 
06 XD (PR) 
OA WX 
3 bytes -- Address 
1 byte -- Alignment if XI; 
otherwise blank 
3 kbytes -- Length, LDID, cr 
blank 
65-72 Blank 
73-76 Deck ID (from first TITLE 
card) 
77-80 Card sequence number 
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END Card | Format 


The format of the END card is as fcllows: 


.Columns Contents 

1 12-2-9 punch 

2-4 ENT 

5 Blank 

6-8 Entry address from operand 
of ENT card in source deck 
(blank if no operand) 

9-14 Blank 

15-16 ESCIC of entry point (blank 
if no operand) 

17-39 Blank 

40-62 Version of the assenbler 


(e.g., F 14FEB66, time 

of the assembly (hh.mm), 

and date of the assembly 
(mm/dd/yy). (See 

“Assembler Listing" section.) 


| SYM Card Format 


If requested by the user, the assembler Ze 
punches out SYM cards with symbclic 

information concerning the assembled 

program. These cards can be used by the 3. 
TESTRAN routine or the TSO Test ccrmand 
processor. The cards are located between 
the ESC and TXT cards. The format of SYM 
cards is as follows: 


Columns Contents > 4a. 

1 12-2-9 punch 

2-4 SYM 

5-10 Blank 

11-12 Variable field count -- 
number of Lytes of text in 
variable field (cc 17-72) 

13-16 Blank 

17-72 Variakle field (see belcw) 

73-76 Leck ID (from first TITLE 
card) 

77-80 Card sequence number 


The variable field (columns 17-72) 
contains up to 56 kytes of TESTRAN text. 
The items making the text are packed 
together, consequently only the last card 5. 
may contain less than 56 bytes of text in 
the variable field. The formats cf a text 
card and an individual text item are shown 
in Figure 19. The contents of the fields 
within an individual entry are as fcllows: 6. 


1. Organization (1 byte) 


0 = non-data type Es 
1 = data type 

Bits 1-3 (if non-data type): 
000 = space 


Notes: 
present for data-type items. 


001 
010 
011 
100 
101 


control section 
dummy contrcl section 
common 

wachine instruction 
CCW 


Bit 1 (if data type): 

0 no multiplicity 
multiplicity (indicates 
presence of M field) 
data type): 

0 = independent (not a 
packed or zoned decimal 
constant) 

1 = cluster (packed or 
zoned decimal constant) 

data type): 

0 no scaling 

scaling (indicates pres- 
ence of S field) 


1 


Bit 2 (if 


Bit 3 (if 


1 


Bit 4s 
0 
1 
Bits 5-7: 
Length of name minus one 


name present 
name -not present 


Address (3 bytes) - displacement from 
beginning of control section 


Symbol Name (0-8 bytes) 
name of particular item 


- symkolic 


The following fields are only 


Data Type (1 byte) - contents in 


hexadecimal 
00 = character 
04 = hexadecimal, L-type data 
08 = binary 
10 = fixed point, full 
14 = fixed point, half 
18 = floating point, short 
1C = floating point, long 
20 = A-type or Q-type data 
24 = Y-type data 
28 = S-type data 
2C = V-type data 
30 = packed decimal 
34 = zoned decimal 
Length (2 bytes for character, 


hexadecimal, or binary items; 1 Lyte 
for other types) - length of data item 
minus 1 


Multiplicity - M field 
equals 1 if not present 


(3 Eytes) - 


Scale -signed integer - S field (2 
bytes) - present only for F, H, E, C, 
L, P and Z type data, and only if 
scale is non-zero. 


